Get contract providers | Candid

curl https://api.joincandidhealth.com/api/contracts/v3/d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32/providers \
     -H "Authorization: Bearer <token>"

{
  "items": [
    {
      "employment_status": "ACTIVE",
      "is_billing": true,
      "is_rendering": true,
      "license_type": "MD",
      "npi": "npi",
      "organization_provider_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
      "provider_type": "INDIVIDUAL",
      "addresses": [
        {
          "address": {
            "address1": "address1",
            "city": "city",
            "state": "AA",
            "zip_code": "zip_code",
            "zip_plus_four_code": "zip_plus_four_code",
            "address2": "address2"
          },
          "address_type": "DEFAULT"
        },
        {
          "address": {
            "address1": "address1",
            "city": "city",
            "state": "AA",
            "zip_code": "zip_code",
            "zip_plus_four_code": "zip_plus_four_code",
            "address2": "address2"
          },
          "address_type": "DEFAULT"
        }
      ],
      "employment_start_date": "employment_start_date",
      "employment_termination_date": "employment_termination_date",
      "first_name": "first_name",
      "last_name": "last_name",
      "medicaid_provider_id": "medicaid_provider_id",
      "organization_name": "organization_name",
      "ptan": "ptan",
      "tax_id": "tax_id",
      "taxonomy_code": "taxonomy_code"
    },
    {
      "employment_status": "ACTIVE",
      "is_billing": true,
      "is_rendering": true,
      "license_type": "MD",
      "npi": "npi",
      "organization_provider_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
      "provider_type": "INDIVIDUAL",
      "addresses": [
        {
          "address": {
            "address1": "address1",
            "city": "city",
            "state": "AA",
            "zip_code": "zip_code",
            "zip_plus_four_code": "zip_plus_four_code",
            "address2": "address2"
          },
          "address_type": "DEFAULT"
        },
        {
          "address": {
            "address1": "address1",
            "city": "city",
            "state": "AA",
            "zip_code": "zip_code",
            "zip_plus_four_code": "zip_plus_four_code",
            "address2": "address2"
          },
          "address_type": "DEFAULT"
        }
      ],
      "employment_start_date": "employment_start_date",
      "employment_termination_date": "employment_termination_date",
      "first_name": "first_name",
      "last_name": "last_name",
      "medicaid_provider_id": "medicaid_provider_id",
      "organization_name": "organization_name",
      "ptan": "ptan",
      "tax_id": "tax_id",
      "taxonomy_code": "taxonomy_code"
    }
  ],
  "next_page_token": "next_page_token",
  "prev_page_token": "prev_page_token"
}

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Path parameters

contract_idUUIDRequired

Query parameters

page_tokenstringOptional

limitintegerOptional

Max number of providers returned per page. Defaults to 100. Max is 1000.

Response

This endpoint returns an object.

itemslist of objects

next_page_tokenstring

prev_page_tokenstring

Errors

404

Entity Not Found Error

422

Unprocessable Entity Error