Get Multi — Candid | API Reference

Gets a list of dimensions with their rates. The rates returned will always be the most recent versions of those rates.

Query parameters

page_tokenstringOptional

limitintegerOptional

Max number of dimensions returned. Defaults to 100. Max is 100.

active_datedateOptional

payer_uuidUUIDOptional

organization_billing_provider_idUUIDOptional

statesenumOptional

zip_codesstringOptional

license_typesenumOptional

facility_type_codesenumOptional

Box 24B on the CMS-1500 claim form. Line-level place of service is not currently supported. 02 for telemedicine, 11 for in-person. Full list here: https://www.cms.gov/Medicare/Coding/place-of-service-codes/Place_of_Service_Code_Set

network_typesenumOptional

cpt_codestringOptional

modifiersenumOptional

Response

This endpoint returns an object

rates

list of objects

A comprehensive rate including the current rate value and all values for historic time ranges. The time ranges specified by each RateEntry are disjoint. A rate must always have at least one entry.

next_page_token

stringOptional

prev_page_token

stringOptional

1 curl -G https://api.joincandidhealth.com/api/fee-schedules/v3 \ 2 -H "Authorization: Bearer <token>" \ 3 -d page_token=string \ 4 -d limit=0

1 { 2 "rates": [ 3 { 4 "rate_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", 5 "dimensions": { 6 "payer_uuid": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", 7 "organization_billing_provider_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", 8 "states": [ 9 "AA" 10 ], 11 "zip_codes": [ 12 "string" 13 ], 14 "license_types": [ 15 "MD" 16 ], 17 "facility_type_codes": [ 18 "01" 19 ], 20 "network_types": [ 21 "12" 22 ], 23 "cpt_code": "string", 24 "modifiers": [ 25 "22" 26 ] 27 }, 28 "version": 0, 29 "updated_at": "2023-01-01", 30 "updated_by": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", 31 "entries": [ 32 { 33 "start_date": "2023-01-01", 34 "rate_cents": 0, 35 "is_deactivated": true, 36 "end_date": "2023-01-01" 37 } 38 ] 39 } 40 ], 41 "next_page_token": "string", 42 "prev_page_token": "string" 43 }

1	curl -G https://api.joincandidhealth.com/api/fee-schedules/v3 \
2	-H "Authorization: Bearer <token>" \
3	-d page_token=string \
4	-d limit=0

1	{
2	"rates": [
3	{
4	"rate_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
5	"dimensions": {
6	"payer_uuid": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
7	"organization_billing_provider_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
8	"states": [
9	"AA"
10	],
11	"zip_codes": [
12	"string"
13	],
14	"license_types": [
15	"MD"
16	],
17	"facility_type_codes": [
18	"01"
19	],
20	"network_types": [
21	"12"
22	],
23	"cpt_code": "string",
24	"modifiers": [
25	"22"
26	]
27	},
28	"version": 0,
29	"updated_at": "2023-01-01",
30	"updated_by": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
31	"entries": [
32	{
33	"start_date": "2023-01-01",
34	"rate_cents": 0,
35	"is_deactivated": true,
36	"end_date": "2023-01-01"
37	}
38	]
39	}
40	],
41	"next_page_token": "string",
42	"prev_page_token": "string"
43	}