Skip to main content
GET
List referrals

​
Query Parameters

  • start_date (string, required): Start of the date range in ISO format (YYYY-MM-DD)
  • end_date (string, required): End of the date range in ISO format (YYYY-MM-DD)
  • patient_mrn (string, optional): Filter by patient MRN
  • status (string, optional): Filter by referral status
  • priority (string, optional): Filter by priority — routine, urgent, or stat
  • direction (string, optional): Filter by referral direction — incoming or outgoing
  • ehr_id (string, optional): Filter by the referral’s EMR ID
  • receiving_line (string, optional): Filter by the receiving line — the fax number that received the document. Accepts any format; the value is canonicalized to E.164 before matching.
  • page (integer, optional): Page number (default: 1)
  • page_size (integer, optional): Results per page, max 100 (default: 100)
  • sort (string, optional): Sort order — pass created_at for ascending, defaults to descending by referral date

​
Example Request

​
Example Response

​
Response Fields

​
Top-Level Fields

  • success (boolean): Whether the request was successful
  • referrals (array): Array of referral objects
  • pagination (object): Pagination metadata

​
Referral Object

  • id (string): Cobalt referral ID (UUID without dashes)
  • ehr_id (string): The referral ID as it appears in the EMR
  • patient_ehr_id (string, nullable): The patient’s EMR ID
  • patient_mrn (string, nullable): Patient medical record number
  • patient_first_name (string, nullable): Patient first name
  • patient_last_name (string, nullable): Patient last name
  • patient_dob (string, nullable): Patient date of birth
  • from_provider_ehr_id (string, nullable): EMR ID of the referring provider
  • from_provider_name (string, nullable): Name of the referring provider
  • to_provider_ehr_id (string, nullable): EMR ID of the provider being referred to
  • to_provider_name (string, nullable): Name of the provider being referred to
  • priority (string, nullable): Referral priority — routine, urgent, or stat
  • urgency (string, nullable): Urgency designation as recorded in the EMR
  • reason (string, nullable): Reason for the referral
  • prior_authorization_code (string, nullable): Prior authorization code recorded on the referral
  • specialty (string, nullable): Referral specialty
  • to_facility_name (string, nullable): Name of the facility the referral is directed to
  • diagnosis_codes (array): ICD-10 diagnosis codes associated with the referral
  • document_ids (array): Cobalt IDs of attached documents (UUIDs without dashes)
  • direction (string, nullable): Referral direction — incoming or outgoing
  • receiving_line (string, nullable): The receiving line — the fax number that received the document — in E.164 format (e.g. +12345678901).
  • status (string, nullable): Current referral status
  • referral_date (string, nullable): Date the referral was created (ISO 8601)
  • last_activity_at (string, nullable): Timestamp of the most recent activity on the referral (ISO 8601)
  • synced_at (string, nullable): Timestamp of the last sync from the EMR (ISO 8601)

​
Notes

  • This endpoint returns referrals from the Cobalt database. Data is updated during scheduled syncs.

Authorizations

​
client_id
string
header
required
​
client_secret
string
header
required
​
access_token
string
header
required

Query Parameters

​
start_date
string
required

Start of the referral date range (ISO 8601, YYYY-MM-DD).

Example:

"2026-03-15"

​
end_date
string
required

End of the referral date range (ISO 8601, YYYY-MM-DD).

Example:

"2026-03-20"

​
patient_mrn
string

Filter by patient Medical Record Number.

Example:

"12345"

​
status
string

Filter by referral status.

Example:

"Sent"

​
priority
string

Filter by referral priority.

Example:

"routine"

​
direction
string

Filter by referral direction (incoming, outgoing).

Example:

"outgoing"

​
ehr_id
string

Filter by the referral’s EHR ID.

Example:

"referral-emr-123"

​
receiving_line
string

Filter by the receiving line.

Example:

"555-123-4568"

​
page
integer
default:1

Page number.

Required range: x >= 1
Example:

1

​
page_size
integer
default:100

Items per page (max 100).

Required range: 1 <= x <= 100
Example:

100

​
sort
enum<string>

Sort order. "created_at" sorts oldest-first; the default is newest-first.

Available options:
created_at
Example:

"created_at"

Response

Referrals for the account

​
success
boolean
required
Example:

true

​
referrals
object[]
required
Example:
​
pagination
object
required