> ## Documentation Index > Fetch the complete documentation index at: https://docs.usecobalt.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Referring Providers > Retrieve referring providers from the EMR system for your organization. ## 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 ```bash theme={null} 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 ```bash theme={null} 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 ```bash theme={null} 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 ```bash theme={null} 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 ```json theme={null} { "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 ## OpenAPI ````yaml GET /referring-providers openapi: 3.0.0 info: title: Cobalt API version: 1.0.1 description: API for interacting with Cobalt's EHR integration services servers: - url: https://api.usecobalt.com/v1 security: - ClientCredentials: [] ClientSecret: [] AccessToken: [] paths: /referring-providers: get: tags: - Referring Providers summary: List referring providers description: Retrieve referring providers from the EMR system for your organization. operationId: getReferringProviders parameters: - name: first_name in: query description: Filter by first name (case-insensitive, partial match) schema: type: string - name: last_name in: query description: Filter by last name (case-insensitive, partial match) schema: type: string - name: phone in: query description: Filter by phone number (accepts any format) schema: type: string - name: fax in: query description: Filter by fax number (accepts any format) schema: type: string - name: npi in: query description: Filter by NPI (exact match) schema: type: string responses: '200': description: Successful response content: application/json: schema: type: object properties: success: type: boolean referring_providers: type: array items: type: object properties: id: type: string description: Cobalt referring provider ID (UUID without dashes) ehr_id: type: string description: >- The referring provider ID as it appears in the EMR system name: type: string description: >- Full name (typically formatted as LASTNAME,FIRSTNAME) first_name: type: string nullable: true description: Provider's first name last_name: type: string nullable: true description: Provider's last name middle_initial: type: string nullable: true description: Provider's middle initial speciality: type: string nullable: true description: >- Medical speciality (e.g., Cardiology, Primary Care Doctor) phone: type: string nullable: true description: Contact phone number in format XXX-XXX-XXXX fax: type: string nullable: true description: Fax number in format XXX-XXX-XXXX email: type: string nullable: true description: Contact email address npi: type: string nullable: true description: National Provider Identifier address_street: type: string nullable: true description: Street address address_city: type: string nullable: true description: City name address_state: type: string nullable: true description: State abbreviation address_zip: type: string nullable: true description: ZIP code '401': description: Unauthorized content: application/json: schema: type: object properties: success: type: boolean message: type: string '404': description: User not found content: application/json: schema: type: object properties: success: type: boolean message: type: string '500': description: Internal server error content: application/json: schema: type: object properties: success: type: boolean message: type: string components: securitySchemes: ClientCredentials: type: apiKey in: header name: client_id ClientSecret: type: apiKey in: header name: client_secret AccessToken: type: apiKey in: header name: access_token ````