Get Referring Providers

Retrieve referring providers from the EMR system for your organization.

GET /referring-providers

List referring providers

cURL

curl --request GET \
  --url https://api.usecobalt.com/v1/referring-providers \
  --header 'access_token: <api-key>' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>'

200

{
  "success": true,
  "referring_providers": [
    {
      "id": "<string>",
      "ehr_id": "<string>",
      "name": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "middle_initial": "<string>",
      "speciality": "<string>",
      "phone": "<string>",
      "fax": "<string>",
      "email": "<string>",
      "npi": "<string>",
      "address_street": "<string>",
      "address_city": "<string>",
      "address_state": "<string>",
      "address_zip": "<string>"
    }
  ]
}

Query Parameters

All parameters are optional and can be combined to filter results:

• 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

Authorizations

client_id · string · header · required

client_secret · string · header · required

access_token · string · header · required

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)

fax · string

Filter by fax number (accepts any format)

npi · string

Filter by NPI (exact match)

Response

200

application/json

Successful response

success · boolean

referring_providers · object[]

Show child attributes