Backwork Ruby SDK

require 'backwork'

client = Backwork::Client.new(api_key: 'bwk_live_YOUR_API_KEY')

code = client.codes.lookup('76942', include: ['rvu', 'policies'])
puts code['data']['description']

prior_auth = client.prior_auth.check(
  procedure_codes: ['76942'],
  diagnosis_codes: ['M54.5'],
  state: 'TX',
  payer: 'medicare'
)

puts prior_auth['data']['pa_required']

result = client.codes.lookup(
  '76942',
  include: ['rvu', 'policies'],
  jurisdiction: 'JM',
  fuzzy: true
)

policies = client.policies.list(
  q: 'ultrasound guidance',
  mode: 'keyword',
  policy_type: 'LCD',
  jurisdiction: 'JM',
  status: 'active',
  limit: 25
)

policy = client.policies.get('L33831', include: ['criteria', 'codes'])

prior_auth = client.prior_auth.check(
  procedure_codes: ['76942'],
  diagnosis_codes: ['M54.5'],
  state: 'TX',
  payer: 'medicare'
)

claim = client.claims.validate(
  procedure_codes: ['99213'],
  diagnosis_codes: ['E11.9'],
  payer: 'Medicare',
  state: 'TX',
  date_of_service: '2026-05-23'
)

puts "#{claim['data']['coverage_status']} #{claim['data']['denial_risk']}"
puts claim['data']['issues']

criteria = client.coverage.search_criteria(
  'diabetes',
  section: 'indications',
  limit: 10
)
puts "#{criteria['data'][0]['policy_id']}: #{criteria['data'][0]['policy_title']}"

spending = client.spending.by_code(codes: ['T1019', 'T1020'], year: 2023)
changes = client.compliance.unreviewed(limit: 10)
stats = client.compliance.stats

formulary = client.drugs.formulary('ozempic', payer: 'all', limit: 5)

begin
  result = client.codes.lookup('76942')
rescue Backwork::AuthError => e
  puts "Invalid API key: #{e.message}"
rescue Backwork::ValidationError => e
  puts "Invalid request: #{e.message}"
rescue Backwork::NotFoundError => e
  puts "Resource not found: #{e.message}"
rescue Backwork::RateLimitError => e
  puts "Rate limit exceeded: #{e.message}"
rescue Backwork::APIError => e
  puts "Backwork API error: #{e.message}"
end

client = Backwork::Client.new(
  api_key: ENV.fetch('BACKWORK_API_KEY'),
  base_url: 'https://backworkhealth.com/api/v1',
  timeout: 30
)