Search Providers

Beta

GET

/patients/v1/search_providers

GET

/patients/v1/search_providers

1 from candid import CandidApiClient
2 
3 client = CandidApiClient(
4     client_id="YOUR_CLIENT_ID",
5     client_secret="YOUR_CLIENT_SECRET",
6 )
7 client.pre_encounter.patients.v_1.search_providers(
8     search_criteria="search_criteria",
9 )

Try it

200Retrieved

1 [
2   {
3     "name": {
4       "family": "family",
5       "given": [
6         "given",
7         "given"
8       ],
9       "use": "USUAL",
10       "period": {
11         "start": "2023-01-15",
12         "end": "2023-01-15"
13       },
14       "suffix": "suffix"
15     },
16     "telecoms": [
17       {
18         "value": "value",
19         "use": "HOME",
20         "period": {
21           "start": "2023-01-15",
22           "end": "2023-01-15"
23         }
24       },
25       {
26         "value": "value",
27         "use": "HOME",
28         "period": {
29           "start": "2023-01-15",
30           "end": "2023-01-15"
31         }
32       }
33     ],
34     "type": "PRIMARY",
35     "npi": "npi",
36     "addresses": [
37       {
38         "use": "HOME",
39         "line": [
40           "line",
41           "line"
42         ],
43         "city": "city",
44         "state": "state",
45         "postal_code": "postal_code",
46         "country": "country",
47         "period": {
48           "start": "2023-01-15",
49           "end": "2023-01-15"
50         }
51       },
52       {
53         "use": "HOME",
54         "line": [
55           "line",
56           "line"
57         ],
58         "city": "city",
59         "state": "state",
60         "postal_code": "postal_code",
61         "country": "country",
62         "period": {
63           "start": "2023-01-15",
64           "end": "2023-01-15"
65         }
66       }
67     ],
68     "period": {
69       "start": "2023-01-15",
70       "end": "2023-01-15"
71     },
72     "canonical_id": "canonical_id",
73     "fax": "fax",
74     "service_facilities": [
75       {
76         "service_facility_id": "service_facility_id"
77       },
78       {
79         "service_facility_id": "service_facility_id"
80       }
81     ]
82   },
83   {
84     "name": {
85       "family": "family",
86       "given": [
87         "given",
88         "given"
89       ],
90       "use": "USUAL",
91       "period": {
92         "start": "2023-01-15",
93         "end": "2023-01-15"
94       },
95       "suffix": "suffix"
96     },
97     "telecoms": [
98       {
99         "value": "value",
100         "use": "HOME",
101         "period": {
102           "start": "2023-01-15",
103           "end": "2023-01-15"
104         }
105       },
106       {
107         "value": "value",
108         "use": "HOME",
109         "period": {
110           "start": "2023-01-15",
111           "end": "2023-01-15"
112         }
113       }
114     ],
115     "type": "PRIMARY",
116     "npi": "npi",
117     "addresses": [
118       {
119         "use": "HOME",
120         "line": [
121           "line",
122           "line"
123         ],
124         "city": "city",
125         "state": "state",
126         "postal_code": "postal_code",
127         "country": "country",
128         "period": {
129           "start": "2023-01-15",
130           "end": "2023-01-15"
131         }
132       },
133       {
134         "use": "HOME",
135         "line": [
136           "line",
137           "line"
138         ],
139         "city": "city",
140         "state": "state",
141         "postal_code": "postal_code",
142         "country": "country",
143         "period": {
144           "start": "2023-01-15",
145           "end": "2023-01-15"
146         }
147       }
148     ],
149     "period": {
150       "start": "2023-01-15",
151       "end": "2023-01-15"
152     },
153     "canonical_id": "canonical_id",
154     "fax": "fax",
155     "service_facilities": [
156       {
157         "service_facility_id": "service_facility_id"
158       },
159       {
160         "service_facility_id": "service_facility_id"
161       }
162     ]
163   }
164 ]

Searches for referring providers that match the query parameters. The search is case-insensitive, supports fuzzy matching, and matches against provider name and NPI. The search criteria must be an alphanumeric string, and the search is limited to the first 20 results.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Query parameters

search_criteriastringRequired

Response

This endpoint returns a list of objects.

nameobject

telecomslist of objects

typeenum or null

Defaults to ATTENDING.

Allowed values:

npistring or null

addresseslist of objects or null

periodobject or null

canonical_idstring or null

The unique identifier for a provider configured in the Candid system

faxstring or null

service_facilitieslist of objects or null

Associated service facilities for this provider.