Get Referring Providers

​

Query Parameters

• first_name (string): Filter by first name (case-insensitive, partial match)
• last_name (string): Filter by last name (case-insensitive, partial match)
• phone (string): Filter by phone number (accepts any format, e.g., “7734722936” or “773-472-2936”)
• fax (string): Filter by fax number (accepts any format)
• npi (string): Filter by NPI (exact match)

​

Example Requests

​

Get All Referring Providers

curl -X GET "https://api.usecobalt.com/v1/referring-providers" \
  -H "client_id: your_client_id" \
  -H "client_secret: your_client_secret" \
  -H "access_token: your_access_token"

​

Filter by Last Name

curl -X GET "https://api.usecobalt.com/v1/referring-providers?last_name=smith" \
  -H "client_id: your_client_id" \
  -H "client_secret: your_client_secret" \
  -H "access_token: your_access_token"

​

Filter by NPI

curl -X GET "https://api.usecobalt.com/v1/referring-providers?npi=1780690362" \
  -H "client_id: your_client_id" \
  -H "client_secret: your_client_secret" \
  -H "access_token: your_access_token"

​

Filter by Phone

curl -X GET "https://api.usecobalt.com/v1/referring-providers?phone=773-472-2936" \
  -H "client_id: your_client_id" \
  -H "client_secret: your_client_secret" \
  -H "access_token: your_access_token"

​

Example Response

{
  "success": true,
  "referring_providers": [
    {
      "id": "e35e82b85df58f08a9b38e06a91e9f1a",
      "ehr_id": "350143",
      "first_name": "jane",
      "last_name": "Doe",
      "middle_initial": null,
      "speciality": "Primary Care Doctor",
      "phone": "222-333-4444",
      "fax": "222-333-4444",
      "email": null,
      "npi": "98374982374",
      "address_street": "3336 N Main AVE",
      "address_city": "Main",
      "address_state": "IL",
      "address_zip": "22333"
    },
  ]
}

​

Response Fields

​

Top-Level Fields

• success (boolean): Whether the request was successful
• referring_providers (array): Array of referring provider objects for the organization

​

Referring Provider Object

• id (string): Cobalt referring provider ID (UUID without dashes)
• ehr_id (string): The referring provider ID as it appears in the EMR system
• name (string): Full name (typically formatted as “LASTNAME,FIRSTNAME”)
• first_name (string): Provider’s first name
• last_name (string): Provider’s last name
• middle_initial (string, nullable): Provider’s middle initial
• speciality (string, nullable): Medical speciality (e.g., “Cardiology”, “Primary Care Doctor”)
• phone (string, nullable): Contact phone number in format XXX-XXX-XXXX
• fax (string, nullable): Fax number in format XXX-XXX-XXXX
• email (string, nullable): Contact email address
• npi (string, nullable): National Provider Identifier
• address_street (string, nullable): Street address
• address_city (string, nullable): City name
• address_state (string, nullable): State abbreviation
• address_zip (string, nullable): ZIP code

​

Notes

• All referring providers returned are active in the system
• Phone and fax numbers are normalized to XXX-XXX-XXXX format
• Search filters are applied as partial matches (except NPI which is exact)
• Results are ordered by last name, then first name alphabetically