Skip to main content
GET
/
bills
/
{id}
Get bill by ID
curl --request GET \
  --url https://api.maxcare.ai/v4/bills/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "code": "success",
  "data": {
    "id": "bil_9a8b7c6d5e4f3a2b1c0de9f8a7b6c5d4",
    "dateOfService": "2025-01-15",
    "billingType": "professional",
    "isCosmetic": false,
    "isBillable": true,
    "virtualEncounter": false,
    "isEmCodingEnabled": true,
    "facilityId": "fac_b2c3d4e5f6a74b8c9d0e1f2a3b4c5d6e",
    "facilityName": "West LA Dermatology",
    "specialty": "Dermatology",
    "codingGroups": [
      {
        "id": "cgr_f6a7b8c9d0e14f2a3b4c5d6e7f8a9b0c",
        "status": "finalized",
        "createdAt": "2025-01-15T09:30:00.000Z",
        "updatedAt": "2025-01-20T14:22:00.000Z",
        "diagnoses": [
          {
            "id": "dgn_a7b8c9d0e1f24a3b4c5d6e7f8a9b0c1d",
            "code": "L70.0",
            "description": "Acne vulgaris",
            "position": 1,
            "codeRevision": "ICD-10-CM"
          }
        ],
        "lineItems": [
          {
            "id": "lit_b8c9d0e1f2a34b4c5d6e7f8a9b0c1d2e",
            "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",
    "patient": {
      "id": "pat_c56103bcd39c46d39f3138dd2b5e05f6",
      "mrn": "MRN-10042",
      "firstName": "Sarah",
      "lastName": "Johnson",
      "middleName": "Marie",
      "gender": "Female",
      "dateOfBirth": "1985-03-15",
      "email": "sarah.johnson@email.com",
      "phone": "(555) 123-4567",
      "createdAt": "2024-08-15T09:30:00.000Z",
      "updatedAt": "2025-01-20T14:22:00.000Z"
    },
    "primaryProvider": {
      "id": "prv_d4e5f6a7b8c94d0e1f2a3b4c5d6e7f8a",
      "firstName": "James",
      "lastName": "Wilson",
      "displayFirstName": "Dr. James",
      "displayLastName": "Wilson, MD",
      "roles": [
        "Physician",
        "Surgeon"
      ],
      "username": "jwilson",
      "individualNpi": "1234567890",
      "canFinalize": true,
      "canCosign": false,
      "createdAt": "2024-06-01T08:00:00.000Z",
      "updatedAt": "2025-02-10T16:45:00.000Z"
    },
    "billUnderProvider": {
      "id": "prv_d4e5f6a7b8c94d0e1f2a3b4c5d6e7f8a",
      "firstName": "James",
      "lastName": "Wilson",
      "displayFirstName": "Dr. James",
      "displayLastName": "Wilson, MD",
      "roles": [
        "Physician",
        "Surgeon"
      ],
      "username": "jwilson",
      "individualNpi": "1234567890",
      "canFinalize": true,
      "canCosign": false,
      "createdAt": "2024-06-01T08:00:00.000Z",
      "updatedAt": "2025-02-10T16:45:00.000Z"
    }
  }
}

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