Skip to main content
GET
/
v1
/
bills
/
{id}
Get bill by ID
curl --request GET \
  --url https://api.example.com/v1/bills/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "code": "success",
  "data": {
    "id": "bill_01J5K8N2XRQV3M7YGWT4HB6E9C",
    "dateOfService": "2025-01-15",
    "billingType": "professional",
    "isCosmetic": false,
    "isBillable": true,
    "virtualEncounter": false,
    "isEmCodingEnabled": true,
    "patientId": "pat_01J5K8N2XRQV3M7YGWT4HB6E9C",
    "patientFirstName": "Sarah",
    "patientLastName": "Johnson",
    "patientDob": "1985-03-15",
    "primaryProviderName": "Dr. James Wilson",
    "billUnderName": "Dr. James Wilson",
    "facilityId": "fac_01J5K8N2XRQV3M7YGWT4HB6E9C",
    "facilityName": "West LA Dermatology",
    "specialty": "Dermatology",
    "codingGroups": [
      {
        "id": "cg_01J5K8N2XRQV3M7YGWT4HB6E9C",
        "status": "finalized",
        "createdAt": "2025-01-15T09:30:00.000Z",
        "updatedAt": "2025-01-20T14:22:00.000Z",
        "diagnoses": [
          {
            "id": "diag_01J5K8N2XRQV3M7YGWT4HB6E9C",
            "code": "L70.0",
            "description": "Acne vulgaris",
            "position": 1,
            "codeRevision": "ICD-10-CM"
          }
        ],
        "lineItems": [
          {
            "id": "li_01J5K8N2XRQV3M7YGWT4HB6E9C",
            "code": "99213",
            "codeType": "CPT",
            "description": "Office/outpatient visit, est patient, low complexity",
            "units": "1",
            "charge": "150.00",
            "totalCharge": "150.00",
            "balance": "30.00",
            "modifiers": [
              {
                "code": "25",
                "name": "Significant, Separately Identifiable E/M Service"
              }
            ],
            "position": 1,
            "linkedDiagnoses": [
              {
                "code": "L70.0",
                "description": "Acne vulgaris",
                "position": 1
              }
            ],
            "ndcCode": "00069-3150-83",
            "ndcQualifier": "N4",
            "ndcQuantity": "1.0"
          }
        ]
      }
    ],
    "primaryInsurance": "Blue Cross Blue Shield",
    "secondaryInsurance": null,
    "createdAt": "2025-01-15T09:30:00.000Z",
    "updatedAt": "2025-01-20T14:22:00.000Z",
    "cliaNumber": "05D2081496",
    "patientMrn": "MRN-10042",
    "patientGender": "Female",
    "primaryProviderId": "prov_01J5K8N2XRQV3M7YGWT4HB6E9C",
    "primaryProviderFirstName": "James",
    "primaryProviderLastName": "Wilson",
    "billUnderProviderId": "prov_01J5K8N2XRQV3M7YGWT4HB6E9C",
    "billUnderProviderFirstName": "James",
    "billUnderProviderLastName": "Wilson"
  }
}

Authorizations

Authorization
string
header
required

Marketplace API key

Headers

X-Organization-Id
string
required

Target clinic organization ID

Path Parameters

id
string
required

Bill ID

Response

Success

code
string
required

Response code

Example:

"success"

data
object
required