Insurance RefundsV1

Create insurance refund

Beta
POST
https://api.joincandidhealth.com/api/insurance-refunds/v1

Creates a new insurance refund record and returns the newly created InsuranceRefund object. The allocations can describe whether the refund is being applied toward a specific service line, claim, or billing provider.

Request

This endpoint expects an object.
payer_identifier
union
amount_cents
integer
allocations
list of objects
refund_timestamp
optional datetime
refund_note
optional string
refund_reason
optional enum
Allowed values: OVERCHARGED

Response

This endpoint return an object.
insurance_refund_id
UUID
payer
object
amount_cents
integer
allocations
list of objects
refund_timestamp
optional datetime
refund_note
optional string
refund_reason
optional enum
Allowed values: OVERCHARGED
POST
/api/insurance-refunds/v1
curl -X POST https://api.joincandidhealth.com/api/insurance-refunds/v1 \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"payer_identifier": {
"type": "payer_info",
"payer_id": "string",
"payer_name": "string"
},
"amount_cents": 0,
"allocations": [
{
"amount_cents": 0,
"target": {
"type": "service_line_by_id",
"value": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
}
}
]
}'
Response
{
"insurance_refund_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
"payer": {
"payer_uuid": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
"payer_id": "string",
"payer_name": "string"
},
"amount_cents": 0,
"allocations": [
{
"amount_cents": 0,
"target": {
"type": "service_line",
"claim_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
"encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
"service_line_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
}
}
],
"refund_timestamp": "2023-01-01T00:00:00Z",
"refund_note": "string",
"refund_reason": "OVERCHARGED"
}