Get the details of a single claim
GET/v1/claims/:id
Get the details of a claim for an Insurer or provider/hospital.
Request
Path Parameters
The id of the claim you want to get
Query Parameters
When present, value should be comma seperated names of field the user would like returned with the response.
Responses
- 200
- 401
- 403
- 422
Success
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- ]
- Array [
- ]
This is the hmo_erp_id when user is an Insurer, and provider_ref when user is a provider.
insurer object
Present only when user is a provider/hospital.
provider object
Present only when user is an Insurer
enrollee object
This is absent if is_floating is truthy.
diagnoses object[]
Status includes: PENDING, APPROVED, PARTIALLY_APPROVED, REJECTED.
PARTIALLY_APPROVED represents when total amount is not equal to the amount approved but not equal to zero(0).
attachments object[]
This is the uploaded filename.
The file URL on Storage.
Images Only Auto-generated URL that utilizes Cloudinary transformations to give a thumbnail of the image attachment, 150px by 150px dimensions.
Images Only Similar to thumbnail URL, but no width specified, only a reduced height to produce a smaller-sized image that can be suitable for previewing the attachment in a modal before the full file is downloaded.
items object[]
This is the hmo_erp_id of the Insurer the claim and claim item belongs.
Status includes: PENDING, APPROVED, PARTIALLY_APPROVED, REJECTED.
benefit objectnullable
Summary of the matched plan benefit for the returned care or treatment item.
The unique ID of the matched plan benefit.
Human-readable label for the matched benefit.
Possible values: [care, care_group, care_type, diagnosis]
Indicates how the benefit was matched.
care_group objectnullable
Care group metadata when the matched benefit comes from a care-group rule.
{
"id": 0,
"ref": "string",
"pile_id": 0,
"insurer": {
"id": 0,
"code": "string",
"name": "string"
},
"provider": {
"id": 0,
"code": "string",
"name": "string"
},
"enrollee": {
"id": 0,
"insurance_no": "string",
"firstname": "string",
"lastname": "string",
"is_floating": true
},
"encounter_date": "2026-04-23",
"created_at": "2026-04-23",
"updated_at": "2026-04-23T14:31:51.425Z",
"submitted_at": "2026-04-23",
"vetted_at": "2026-04-23",
"diagnoses": [
{
"id": 0,
"icd_code": "string",
"name": "string"
}
],
"amount_billed": 0,
"amount_approved": 0,
"status": "string",
"attachments": [
{
"id": 0,
"title": "string",
"file_type": "string",
"filename": "string",
"file_url": "string",
"thumbnail_url": "string",
"preview_url": "string"
}
],
"items": [
{
"ref": "string",
"description": "string",
"unit_price_billed": 0,
"unit_price_approved": 0,
"qty_billed": 0,
"qty_approved": 0,
"sub_total_billed": 0,
"sub_total_approved": 0,
"comments": [
"string"
],
"status": "string",
"benefit": {
"id": 0,
"label": "string",
"source_type": "care",
"care_group": {
"id": 0,
"name": "string"
}
}
}
]
}
Unauthenticated
Forbidden
Unprocessable Entity