Get all organization providers | Candid

curl -G https://api.joincandidhealth.com/api/organization-providers/v3 \
     -H "Authorization: Bearer <token>" \
     -d limit=100 \
     -d search_term=john \
     -d npi=1234567890 \
     -d is_rendering=true \
     -d is_billing=true \
     -d page_token=eyJ0b2tlbiI6IjEiLCJwYWdlX3Rva2VuIjoiMiJ9 \
     --data-urlencode sort=provider_name:asc

{
  "items": [
    {
      "npi": "1234567890",
      "is_rendering": true,
      "is_billing": true,
      "provider_type": "INDIVIDUAL",
      "license_type": "MD",
      "organization_provider_id": "965A563A-0285-4910-9569-E3739C0F6EAB",
      "qualifications": [
        {
          "identifier_code": "MCR",
          "identifier_id": "123e4567-e89b-12d3-a456-426614174000",
          "identifier_value": {
            "type": "medicare_provider_identifier",
            "provider_number": "1234567890",
            "state": "CA"
          }
        }
      ],
      "first_name": "John",
      "last_name": "Doe",
      "organization_name": "Acme Medical",
      "tax_id": "123456789",
      "taxonomy_code": "1234567890",
      "employment_start_date": "2020-10-07",
      "employment_termination_date": "2021-10-07"
    }
  ]
}

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Query parameters

limitintegerOptional

Limit the number of results returned. Defaults to 100.

search_termstringOptional

Filter to a name or a part of a name.

npistringOptional

Filter to a specific NPI.

is_renderingbooleanOptional

Filter to only rendering providers.

is_billingbooleanOptional

Filter to only billing providers.

organization_provider_idsUUIDOptional

Filter to the provided organization provider IDs.

page_tokenstringOptional

The page token to continue paging through a previous request.

sortenumOptional

Defaults to PROVIDER_NAME_ASC.

Allowed values:

organization_idUUIDOptional

Filter to a specific organization's providers. If not provided, defaults to the requesting user's organization.

Response

This endpoint returns an object.

itemslist of objects

next_page_tokenstring

prev_page_tokenstring