Get patient refunds

Beta

GET

/api/patient-refunds/v1

Returns all patient refunds satisfying the search criteria AND whose organization_id matches the current organization_id of the authenticated user.

Query parameters

limitintegerOptional

Defaults to 100. The value must be greater than 0 and less than 1000.

patient_external_idstringOptional

claim_idUUIDOptional

service_line_idUUIDOptional

billing_provider_idUUIDOptional

unattributedbooleanOptional

returns payments with unattributed allocations if set to true

invoice_idUUIDOptional

sourcesenumOptional

sortenumOptional

Defaults to refund_timestamp

Allowed values: refund_sourceamount_centsrefund_timestamprefund_reasonrefund_note

sort_direction"asc" or "desc"Optional

Sort direction. Defaults to descending order if not provided.

Allowed values: ascdesc

page_tokenstringOptional

Response

This endpoint returns an object.

itemslist of objects

next_page_tokenstringOptional

prev_page_tokenstringOptional

Errors

GET

1 curl -G https://api.joincandidhealth.com/api/patient-refunds/v1 \
2      -H "Authorization: Bearer <token>" \
3      -d limit=0 \
4      -d patient_external_id=string

1 {
2   "items": [
3     {
4       "patient_refund_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
5       "organization_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
6       "refund_source": "MANUAL_ENTRY",
7       "amount_cents": 0,
8       "patient_external_id": "string",
9       "allocations": [
10         {
11           "amount_cents": 0,
12           "target": {
13             "type": "service_line",
14             "claim_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
15             "encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
16             "service_line_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
17           }
18         }
19       ],
20       "source_internal_id": "string",
21       "refund_timestamp": "2023-01-01T00:00:00Z",
22       "refund_note": "string",
23       "invoice": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
24       "refund_reason": "OVERCHARGED"
25     }
26   ],
27   "next_page_token": "string",
28   "prev_page_token": "string"
29 }

Built with

1	curl -G https://api.joincandidhealth.com/api/patient-refunds/v1 \
2	-H "Authorization: Bearer <token>" \
3	-d limit=0 \
4	-d patient_external_id=string

1	{
2	"items": [
3	{
4	"patient_refund_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
5	"organization_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
6	"refund_source": "MANUAL_ENTRY",
7	"amount_cents": 0,
8	"patient_external_id": "string",
9	"allocations": [
10	{
11	"amount_cents": 0,
12	"target": {
13	"type": "service_line",
14	"claim_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
15	"encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
16	"service_line_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
17	}
18	}
19	],
20	"source_internal_id": "string",
21	"refund_timestamp": "2023-01-01T00:00:00Z",
22	"refund_note": "string",
23	"invoice": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
24	"refund_reason": "OVERCHARGED"
25	}
26	],
27	"next_page_token": "string",
28	"prev_page_token": "string"
29	}