curl --request GET \
--url https://api.maxcare.ai/v3/bills \
--header 'Authorization: Bearer <token>' \
--header 'X-Organization-Id: <x-organization-id>'{
"code": "success",
"data": {
"bills": [
{
"id": "bil_9a8b7c6d5e4f3a2b1c0de9f8a7b6c5d4",
"dateOfService": "2025-01-15",
"billingType": "professional",
"isCosmetic": false,
"isBillable": true,
"virtualEncounter": false,
"isEmCodingEnabled": true,
"patientId": "pat_c56103bcd39c46d39f3138dd2b5e05f6",
"patientFirstName": "Sarah",
"patientLastName": "Johnson",
"patientDob": "1985-03-15",
"primaryProviderName": "Dr. James Wilson",
"billUnderName": "Dr. James Wilson",
"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"
}
],
"pagination": {
"page": 1,
"pageSize": 100,
"totalCount": 250,
"totalPages": 3
}
}
}Returns a paginated list of bills. Requires read:bills scope.
curl --request GET \
--url https://api.maxcare.ai/v3/bills \
--header 'Authorization: Bearer <token>' \
--header 'X-Organization-Id: <x-organization-id>'{
"code": "success",
"data": {
"bills": [
{
"id": "bil_9a8b7c6d5e4f3a2b1c0de9f8a7b6c5d4",
"dateOfService": "2025-01-15",
"billingType": "professional",
"isCosmetic": false,
"isBillable": true,
"virtualEncounter": false,
"isEmCodingEnabled": true,
"patientId": "pat_c56103bcd39c46d39f3138dd2b5e05f6",
"patientFirstName": "Sarah",
"patientLastName": "Johnson",
"patientDob": "1985-03-15",
"primaryProviderName": "Dr. James Wilson",
"billUnderName": "Dr. James Wilson",
"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"
}
],
"pagination": {
"page": 1,
"pageSize": 100,
"totalCount": 250,
"totalPages": 3
}
}
}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.
Marketplace API key
Target clinic organization ID
Filter from date (ISO 8601)
"2025-01-01"
Filter to date (ISO 8601)
"2025-12-31"
Filter by facility ID
Filter by patient ID
Filter by provider ID
Filter by integration status
Filter by billing type