Get Unique Values For Dimension — Candid

Gets unique values for a dimension based on other selection criteria. The response is a list of dimensions with your criteria and the unique values populated. This API is useful for driving pivots on dimension values.

Query parameters

page_tokenstringOptional

limitintegerOptional

Max number of values returned. Defaults to 1000. Max is 1000.

pivot_dimensionenumRequired

The name of the dimension to fetch unique values for.

Allowed values: payer_uuidorganization_billing_provider_idcpt_code

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

dimensions

list of objects

A dimensions object where all properties are optional.

next_page_token

stringOptional

prev_page_token

stringOptional

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

1 { 2 "dimensions": [ 3 { 4 "states": [ 5 "AA" 6 ], 7 "zip_codes": [ 8 "string" 9 ], 10 "license_types": [ 11 "MD" 12 ], 13 "facility_type_codes": [ 14 "01" 15 ], 16 "network_types": [ 17 "12" 18 ], 19 "modifiers": [ 20 "22" 21 ], 22 "payer_uuid": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", 23 "organization_billing_provider_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32", 24 "cpt_code": "string" 25 } 26 ], 27 "next_page_token": "string", 28 "prev_page_token": "string" 29 }

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

1	{
2	"dimensions": [
3	{
4	"states": [
5	"AA"
6	],
7	"zip_codes": [
8	"string"
9	],
10	"license_types": [
11	"MD"
12	],
13	"facility_type_codes": [
14	"01"
15	],
16	"network_types": [
17	"12"
18	],
19	"modifiers": [
20	"22"
21	],
22	"payer_uuid": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
23	"organization_billing_provider_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
24	"cpt_code": "string"
25	}
26	],
27	"next_page_token": "string",
28	"prev_page_token": "string"
29	}