Insurance AdjudicationsV1

Create insurance adjudication

Beta
POST
https://api.joincandidhealth.com/api/insurance-adjudications/v1
Creates a new insurance adjudication record and returns the newly created InsuranceAdjudication object.

Request

This endpoint expects an object.
payer_identifier
union
payee
object
check_date
date
claims
map from UUIDs to lists of objects
post_date
optional date
check_number
optional string
note
optional string

Response

This endpoint return an object.
insurance_adjudication_id
UUID
payer_uuid
UUID
check_date
date
claims
map from UUIDs to lists of objects
post_date
optional date
check_number
optional string
note
optional string

Errors

POST
/api/insurance-adjudications/v1
curl -X POST https://api.joincandidhealth.com/api/insurance-adjudications/v1 \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"payer_identifier": {
"type": "payer_info",
"payer_id": "string",
"payer_name": "string"
},
"payee": {
"payee_name": "string",
"payee_identifier": {
"type": "npi",
"value": "string"
}
},
"check_date": "2023-01-01",
"claims": {
"d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32": [
{
"claim_status_code": "1",
"service_lines": {
"d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32": [
{
"carcs": [
{
"group_code": "CO",
"reason_code": "1",
"amount_cents": 0
}
],
"rarcs": [
{
"reason_code": "M1"
}
]
}
]
},
"carcs": [
{
"group_code": "CO",
"reason_code": "1",
"amount_cents": 0
}
]
}
]
}
}'
Response
{
"insurance_adjudication_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
"payer_uuid": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
"check_date": "2023-01-01",
"claims": {
"d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32": [
{
"claim_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
"service_lines": {
"d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32": [
{
"service_line_adjudication_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
"carcs": [
{
"group_code": "CO",
"reason_code": "1",
"amount_cents": 0
}
],
"rarcs": [
{
"reason_code": "M1"
}
],
"denial_reason": "Authorization Required",
"insurance_allowed_amount_cents": 0,
"insurance_paid_amount_cents": 0,
"deductible_amount_cents": 0,
"coinsurance_amount_cents": 0,
"copay_amount_cents": 0
}
]
},
"carcs": [
{
"group_code": "CO",
"reason_code": "1",
"amount_cents": 0
}
],
"insurance_allowed_amount_cents": 0,
"insurance_paid_amount_cents": 0,
"charge_amount_cents": 0,
"payer_claim_number": "string"
}
]
},
"post_date": "2023-01-01",
"check_number": "string",
"note": "string"
}