Supergood | Billed Right API
Programmatically access medical billing, claims, denials, remittances, and provider credentialing workflows in Billed Right with a stable REST API. Supergood builds and operates production-grade, unofficial Billed Right integrations so your team can automate end-to-end revenue cycle operations without heavy custom engineering.
In plain English: Billed Right is a healthcare revenue cycle management (RCM) and medical billing company that helps clinics and provider groups get paid correctly and on time. An unofficial API would let your startup pull live claim statuses, ERAs (835s), denials, patient balances, and payer information—and push encounters, charges, and claim submissions—so you can automate billing, AR workflows, and reporting.
If you’re a healthcare tech company integrating with Billed Right—whether you build an EHR, scheduling platform, eligibility/authorization tool, or provider CRM—you could synchronize patients and insurance, create and submit claims from captured encounters, track remittances, and resolve denials programmatically. That means your users gain features like embedded billing dashboards, automated claim submission, payment reconciliation, and denial worklists, all driven by data you pull and push through Supergood’s API.
What is Billed Right?
Billed Right provides outsourced medical billing, coding, credentialing, and practice management services for healthcare providers. Their teams and tooling support charge capture, coding audits, claim submission, insurance follow-up, denial management, payment posting, and analytics across commercial payers and Medicare/Medicaid. Practices rely on Billed Right to manage day-to-day revenue operations, interface with clearinghouses, and keep reimbursement flowing.
Core product areas include:
- Medical billing and coding (CPT/HCPCS, ICD-10, modifiers)
- Claims submission and clearinghouse management (837P/I)
- Denial management and AR follow-up
- ERA/EOB payment posting (835) and reconciliation
- Eligibility and authorization coordination
- Provider credentialing and payer enrollment
- Reporting and practice performance analytics
Common data entities:
- Patients and guarantors
- Insurance policies and payers
- Encounters and charges (procedures, diagnoses, DOS, POS)
- Claims (status, rejection/denial codes, control numbers)
- Remittances/ERAs (payments, adjustments, CARC/RARC codes)
- Denials and appeal artifacts
- Providers (NPI, specialties) and credentialing status
- Facilities/locations and billing entities
The Billed Right Integration Challenge
Teams depend on Billed Right to run revenue operations, but turning portal- and file-based billing workflows into automated pipelines is tricky:
- Payer variability: Rules for coding, modifiers, and submission differ across payers and lines of business; edits and resubmissions require precise audit trails
- Enterprise security: SSO/MFA and IP controls complicate headless automation from your app or backend
- Portal-first processes: Key claim status, denial queues, and payment artifacts often live behind web UIs or batch exports—not unified public APIs
- EDI interfaces and timing windows: 837/835 flows run via clearinghouses, SFTP, and batched submission schedules that must be respected
- Compliance and privacy: PHI/PII handling, least-privilege access, and retention rules demand disciplined automation
How Supergood Creates Billed Right APIs
Supergood reverse-engineers authenticated browser flows, batch interfaces, and network interactions to deliver a resilient API endpoint layer.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes patients, encounters, claims, remittances, and denials across payer workflows
- Aligns with customer entitlements and licensing constraints to ensure compliant access
- Bridges clearinghouse/SFTP/EDI flows with signed URL retrieval, delivery, and artifact management
Use Cases
EHR-to-Billing Synchronization
- Push patient demographics and insurance from your EHR into Billed Right
- Create encounters/charges automatically from documentation, ensuring CPT/ICD-10 alignment
- Maintain a single source of truth for eligibility and payers
Authorization-Aware Encounter Creation
- Validate active insurance and authorization requirements before capturing charges
- Surface payer-specific rules to clinicians and billers at time of service
- Prevent over-utilization with unit tracking for authorized services
Denial Worklists and AR Automation
- Pull denial queues with CARC/RARC codes for triage and appeals
- Route tasks to staff with context (claim history, payer notes, requested documents)
- Automate resubmission once corrections and appeal artifacts are attached
Claims Generation and Reimbursement Tracking
- Assemble 837P/I claims from approved encounters
- Submit via configured clearinghouse and track control numbers
- Reconcile ERAs (835) and post payments with adjustments back to your system
Audit and Compliance
- Export machine-readable claim/encounter packets with coding audits and edits
- Maintain audit trails for changes to charges and resubmissions
- Provide transparency for payer communications and credentialing milestones
Available Endpoints
Authentication
POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/sessions \
--header 'Authorization: Basic <Base64 encoded token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "[email protected]",
"password": "<password>",
"mfa": {
"type": "totp",
"code": "123456"
}
}'
Example response
{
"authToken": "eyJhbGciOi...",
"expiresIn": 3600,
"user": {
"id": "u_ba19de",
"name": "Billing Admin",
"entitlements": ["patients", "encounters", "claims", "remittances"]
}
}
Patients
GET /patients: Retrieve patient and insurance profiles used for billing. Use this to synchronize demographics, guarantors, and primary/secondary insurance.
Query parameters
- practiceId: string
- updatedSince: ISO 8601 timestamp
- insuranceActiveOn: ISO 8601 date
- payerId: string
Example response
{
"items": [
{
"patientId": "pat_7f3c91",
"mrn": "MRN-002318",
"name": {"first": "Jordan", "last": "Patel"},
"dob": "1989-04-02",
"sex": "M",
"contact": {"phone": "+1-555-0133", "email": "[email protected]"},
"address": {
"line1": "100 Care Way",
"city": "Orlando",
"region": "FL",
"postalCode": "32801"
},
"guarantor": {"name": "Jordan Patel", "relationship": "self"},
"insurances": [
{
"sequence": 1,
"payerId": "payer_bcbs-fl",
"planName": "BCBS PPO",
"memberId": "X1234567",
"groupNumber": "GRP-88421",
"effectiveStart": "2026-01-01",
"effectiveEnd": null
}
],
"updatedAt": "2026-01-19T13:54:12Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Encounters & Charges
POST /encounters: Create or update an encounter and associated charge lines (procedures, diagnoses, modifiers). Supports coding edits and audit notes.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/encounters \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"patientId": "pat_7f3c91",
"providerId": "prv_41cf92",
"billingEntityId": "be_1029f1",
"dateOfService": "2026-01-19",
"placeOfService": "11",
"diagnoses": [
{"code": "I10", "description": "Essential (primary) hypertension"},
{"code": "E11.9", "description": "Type 2 diabetes mellitus without complications"}
],
"procedures": [
{"cpt": "99214", "modifiers": ["25"], "units": 1, "chargeAmount": 165.00},
{"cpt": "83036", "modifiers": [], "units": 1, "chargeAmount": 30.00}
],
"notes": "Established patient visit; A1c checked.",
"referenceId": "ehr-enc-42391"
}'
Example response
{
"encounterId": "enc_58d3e0",
"status": "ready_for_billing",
"codingEdits": [],
"createdAt": "2026-01-19T15:02:02Z",
"referenceId": "ehr-enc-42391"
}
Claims
POST /claims: Assemble and stage an 837P/I claim from approved encounters. Supergood normalizes service lines and can route the generated file to the configured clearinghouse.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/claims \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"claimType": "837P",
"payerId": "payer_bcbs-fl",
"billingProvider": {
"npi": "1234567890",
"taxonomy": "207Q00000X",
"name": "Downtown Family Medicine",
"billingAddress": {
"line1": "200 Practice Ave",
"city": "Orlando",
"region": "FL",
"postalCode": "32801"
}
},
"encounters": [
{"encounterId": "enc_58d3e0"}
],
"submissionChannel": "clearinghouse",
"referenceId": "billing-batch-jan19"
}'
Example response
{
"claimId": "clm_71af2b",
"status": "queued",
"edi": {"format": "837P", "size": 49321},
"submissionChannel": "clearinghouse",
"createdAt": "2026-01-19T16:05:42Z",
"controlNumber": "CN-00012893",
"reviewUrl": "https://download.billedright.example/signed/abc123...",
"referenceId": "billing-batch-jan19"
}
GET /claims: Retrieve claims with current statuses, payer responses, and rejection/denial codes.
Query parameters
- practiceId: string
- payerId: string
- status: enum (queued, submitted, accepted, rejected, denied, paid, partially_paid)
- updatedSince: ISO 8601 timestamp
Example response
{
"items": [
{
"claimId": "clm_71af2b",
"payerId": "payer_bcbs-fl",
"claimType": "837P",
"status": "accepted",
"controlNumber": "CN-00012893",
"icn": "ICN-77820154",
"totals": {"billed": 195.00, "allowed": 160.00, "paid": 128.00},
"rejections": [],
"denials": [],
"updatedAt": "2026-01-20T11:14:07Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Remittances (835)
GET /remittances: Retrieve ERA payment summaries, including claim- and service-line-level adjustments (CARC/RARC) for reconciliation.
Query parameters
- payerId: string
- postedSince: ISO 8601 timestamp
- practiceId: string
Example response
{
"items": [
{
"remittanceId": "era_9a21c0",
"payerId": "payer_bcbs-fl",
"paymentDate": "2026-01-21",
"paymentAmount": 128.00,
"eftTraceNumber": "EFT-66512019",
"claims": [
{
"claimId": "clm_71af2b",
"icn": "ICN-77820154",
"paid": 128.00,
"adjustments": [
{"code": "CO-45", "amount": 32.00, "reason": "Contractual obligation"}
],
"serviceLines": [
{
"cpt": "99214",
"units": 1,
"billed": 165.00,
"allowed": 140.00,
"paid": 112.00,
"adjustments": [
{"code": "CO-45", "amount": 25.00}
]
},
{
"cpt": "83036",
"units": 1,
"billed": 30.00,
"allowed": 20.00,
"paid": 16.00,
"adjustments": [
{"code": "PR-1", "amount": 4.00, "reason": "Deductible"}
]
}
]
}
]
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Technical Specifications
- Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
- Response format: JSON with consistent resource schemas and pagination
- Rate limits: Tuned for enterprise throughput while honoring licensing and usage controls
- Session management: Automatic reauth and cookie/session rotation with health checks
- Data freshness: Near real-time retrieval of patients, encounters, claims, and ERA artifacts
- Security: Encrypted transport, scoped tokens, and audit logging; respects Billed Right entitlements and compliance requirements
- Webhooks: Optional asynchronous delivery for claim status changes, ERA posting, and denial updates
Performance Characteristics
- Latency: Sub-second responses for list/detail queries under normal load
- Throughput: Designed for high-volume charge capture and batch claims pipelines
- Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
- Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your Billed Right product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened Billed Right adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Billed Right evolves.
Frequently Asked Questions
Q: Which Billed Right workflows can this integration cover?
Supergood supports common RCM workflows subject to your licensing and entitlements, including patients/insurance sync, encounters/charges, claim assembly and submission, denial queues, and ERA payment retrieval/posting.
Q: How are MFA, SSO, and clearinghouse interfaces handled for automation?
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. For batch flows, we manage clearinghouse submission windows, generate 837 files, and retrieve ERAs with signed URL retrieval or SFTP.
Q: Can I generate claims directly from encounters?
Yes. You can assemble 837P/I from approved encounters with payer-specific formatting. We can route submissions via your configured clearinghouse and return statuses, control numbers, and payment artifacts for reconciliation.
Related Integrations
Intralinks API - Programmatically access the Intralinks VDR with Supergood
Ready to automate your Billed Right workflows?
Supergood can have your Billed Right integration live in days with no ongoing engineering maintenance.
