Skip to main content
GET
/
v1
/
bills
List bills
curl --request GET \
  --url https://api.example.com/v1/bills \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <x-organization-id>'
{
  "code": "success",
  "data": {
    "bills": [
      {
        "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"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 100,
      "totalCount": 250,
      "totalPages": 3
    }
  }
}

Authorizations

Authorization
string
header
required

Marketplace API key

Headers

X-Organization-Id
string
required

Target clinic organization ID

Query Parameters

dateFrom
string

Filter from date (ISO 8601)

Example:

"2025-01-01"

dateTo
string

Filter to date (ISO 8601)

Example:

"2025-12-31"

facilityId
string

Filter by facility ID

patientId
string

Filter by patient ID

providerId
string

Filter by provider ID

integrationStatus
string

Filter by integration status

billingType
string

Filter by billing type

Response

Success

code
string
required

Response code

Example:

"success"

data
object
required