Get claim by ID
curl --request GET \
--url https://api.maxcare.ai/v4/claims/{id} \
--header 'Authorization: Bearer <token>' \
--header 'X-Organization-Id: <x-organization-id>'import requests
url = "https://api.maxcare.ai/v4/claims/{id}"
headers = {
"X-Organization-Id": "<x-organization-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Organization-Id': '<x-organization-id>', Authorization: 'Bearer <token>'}
};
fetch('https://api.maxcare.ai/v4/claims/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.maxcare.ai/v4/claims/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"X-Organization-Id: <x-organization-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.maxcare.ai/v4/claims/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Organization-Id", "<x-organization-id>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.maxcare.ai/v4/claims/{id}")
.header("X-Organization-Id", "<x-organization-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.maxcare.ai/v4/claims/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Organization-Id"] = '<x-organization-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"code": "success",
"data": {
"id": "clm_c9d0e1f2a3b44c5d6e7f8a9b0c1d2e3f",
"claimAmount": "450.00",
"balance": "120.00",
"claimStatus": "accepted",
"submittedDate": "2025-01-16",
"claimCreatedDate": "2025-01-15",
"billId": "bil_9a8b7c6d5e4f3a2b1c0de9f8a7b6c5d4",
"dateOfService": "2025-01-15",
"billHumanId": "BILL-78432",
"facilityId": "fac_b2c3d4e5f6a74b8c9d0e1f2a3b4c5d6e",
"facilityName": "West LA Dermatology",
"specialty": "Dermatology",
"primaryInsurance": "Blue Cross Blue Shield",
"secondaryInsurance": null,
"payerName": "Blue Cross Blue Shield of Michigan",
"payerCode": "BCBSM",
"payerPosition": 1,
"deepLinkUrl": "https://practice.modmed.com/ema/web/practice/staff/#/practice/staff/financial/home/claims/78432",
"createdAt": "2025-01-15T09:30:00.000Z",
"updatedAt": "2025-01-20T14:22:00.000Z",
"cliaNumber": "05D2081496",
"insurance": [
{
"payerName": "Blue Cross Blue Shield",
"payerCode": "BS001",
"planName": "PPO Gold",
"policyType": "PPO",
"isPrimary": true,
"memberId": "XYZ123456789",
"groupNumber": "GRP-98765",
"policyNumber": "POL-2025-001234",
"subscriberName": "Sarah Johnson",
"copayAmount": "30.00",
"deductibleRemaining": "1500.00"
}
],
"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",
"paidAmount": "142.35",
"allowedAmount": "180.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>"
}
]
}
],
"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",
"npiSource": "ehr",
"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",
"npiSource": "ehr",
"canFinalize": true,
"canCosign": false,
"createdAt": "2024-06-01T08:00:00.000Z",
"updatedAt": "2025-02-10T16:45:00.000Z"
}
}
}{
"code": "bad_request",
"message": "'id' must be a valid UUID",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"code": "unauthorized",
"message": "Invalid or missing API key",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"code": "forbidden",
"message": "Insufficient scope",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"code": "not_found",
"message": "Resource not found",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Maximum 1000 requests per 60 seconds.",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}Claims
Get claim by ID
Returns a single claim with full detail including insurance info. Requires read:claims scope.
GET
/
claims
/
{id}
Get claim by ID
curl --request GET \
--url https://api.maxcare.ai/v4/claims/{id} \
--header 'Authorization: Bearer <token>' \
--header 'X-Organization-Id: <x-organization-id>'import requests
url = "https://api.maxcare.ai/v4/claims/{id}"
headers = {
"X-Organization-Id": "<x-organization-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Organization-Id': '<x-organization-id>', Authorization: 'Bearer <token>'}
};
fetch('https://api.maxcare.ai/v4/claims/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.maxcare.ai/v4/claims/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"X-Organization-Id: <x-organization-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.maxcare.ai/v4/claims/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Organization-Id", "<x-organization-id>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.maxcare.ai/v4/claims/{id}")
.header("X-Organization-Id", "<x-organization-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.maxcare.ai/v4/claims/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Organization-Id"] = '<x-organization-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"code": "success",
"data": {
"id": "clm_c9d0e1f2a3b44c5d6e7f8a9b0c1d2e3f",
"claimAmount": "450.00",
"balance": "120.00",
"claimStatus": "accepted",
"submittedDate": "2025-01-16",
"claimCreatedDate": "2025-01-15",
"billId": "bil_9a8b7c6d5e4f3a2b1c0de9f8a7b6c5d4",
"dateOfService": "2025-01-15",
"billHumanId": "BILL-78432",
"facilityId": "fac_b2c3d4e5f6a74b8c9d0e1f2a3b4c5d6e",
"facilityName": "West LA Dermatology",
"specialty": "Dermatology",
"primaryInsurance": "Blue Cross Blue Shield",
"secondaryInsurance": null,
"payerName": "Blue Cross Blue Shield of Michigan",
"payerCode": "BCBSM",
"payerPosition": 1,
"deepLinkUrl": "https://practice.modmed.com/ema/web/practice/staff/#/practice/staff/financial/home/claims/78432",
"createdAt": "2025-01-15T09:30:00.000Z",
"updatedAt": "2025-01-20T14:22:00.000Z",
"cliaNumber": "05D2081496",
"insurance": [
{
"payerName": "Blue Cross Blue Shield",
"payerCode": "BS001",
"planName": "PPO Gold",
"policyType": "PPO",
"isPrimary": true,
"memberId": "XYZ123456789",
"groupNumber": "GRP-98765",
"policyNumber": "POL-2025-001234",
"subscriberName": "Sarah Johnson",
"copayAmount": "30.00",
"deductibleRemaining": "1500.00"
}
],
"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",
"paidAmount": "142.35",
"allowedAmount": "180.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>"
}
]
}
],
"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",
"npiSource": "ehr",
"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",
"npiSource": "ehr",
"canFinalize": true,
"canCosign": false,
"createdAt": "2024-06-01T08:00:00.000Z",
"updatedAt": "2025-02-10T16:45:00.000Z"
}
}
}{
"code": "bad_request",
"message": "'id' must be a valid UUID",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"code": "unauthorized",
"message": "Invalid or missing API key",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"code": "forbidden",
"message": "Insufficient scope",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"code": "not_found",
"message": "Resource not found",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Maximum 1000 requests per 60 seconds.",
"trace_id": "550e8400-e29b-41d4-a716-446655440000"
}