Skip to main content
GET
/
bills
/
{id}
Get bill by ID
curl --request GET \
  --url https://api.maxcare.ai/v2/bills/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "code": "success",
  "data": {
    "id": "9a8b7c6d-5e4f-3a2b-1c0d-e9f8a7b6c5d4",
    "dateOfService": "2025-01-15",
    "billingType": "professional",
    "isCosmetic": false,
    "isBillable": true,
    "virtualEncounter": false,
    "isEmCodingEnabled": true,
    "patientId": "c56103bc-d39c-46d3-9f31-38dd2b5e05f6",
    "patientFirstName": "Sarah",
    "patientLastName": "Johnson",
    "patientDob": "1985-03-15",
    "primaryProviderName": "Dr. James Wilson",
    "billUnderName": "Dr. James Wilson",
    "facilityId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
    "facilityName": "West LA Dermatology",
    "specialty": "Dermatology",
    "codingGroups": [
      {
        "id": "f6a7b8c9-d0e1-4f2a-3b4c-5d6e7f8a9b0c",
        "status": "finalized",
        "createdAt": "2025-01-15T09:30:00.000Z",
        "updatedAt": "2025-01-20T14:22:00.000Z",
        "diagnoses": [
          {
            "id": "a7b8c9d0-e1f2-4a3b-4c5d-6e7f8a9b0c1d",
            "code": "L70.0",
            "description": "Acne vulgaris",
            "position": 1,
            "codeRevision": "ICD-10-CM"
          }
        ],
        "lineItems": [
          {
            "id": "b8c9d0e1-f2a3-4b4c-5d6e-7f8a9b0c1d2e",
            "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",
            "ndcProcedureDescription": "<string>"
          }
        ]
      }
    ],
    "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": "d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
    "primaryProviderFirstName": "James",
    "primaryProviderLastName": "Wilson",
    "billUnderProviderId": "d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
    "billUnderProviderFirstName": "James",
    "billUnderProviderLastName": "Wilson"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.maxcare.ai/llms.txt

Use this file to discover all available pages before exploring further.

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