Skip to main content
GET
List providers

​
Understanding Provider IDs

Each provider has two identifiers:
  • id: Cobalt’s internal identifier (32-character UUID without hyphens)
    • Use when updating provider settings like status or hours
    • Operations: PATCH /v1/providers/{id}
  • ehr_id: Your EMR system’s provider identifier
    • Use when creating appointments or other EMR operations
    • Operations: POST /v1/appointments (provider field)
Why two IDs? Different operations work in different contexts. Provider management (updating status, hours) modifies Cobalt’s cached configuration, while appointment creation communicates directly with your EMR. Cobalt uses its own IDs to manage provider settings independently of EMR constraints, then maps to EMR IDs when interacting with your EMR system.
Quick Reference:
  • Updating provider settings → Use id
  • Creating appointments → Use ehr_id

​
Example Request

To resolve a provider’s Cobalt id from an EHR-native identifier you already hold (for example when setting pcp_id on a patient), filter by ehr_id:

​
Example Response

​
Response Parameters

​
Provider Fields

  • id: Cobalt’s internal provider identifier (used for updating provider settings)
  • ehr_id: EMR system’s provider identifier (used for creating appointments)
  • timezone: Provider’s timezone
  • npi: National Provider Identifier
  • name: Provider’s name
  • status: Provider status (active or inactive)
    • active: Provider’s schedule will be synced from the EMR
    • inactive: Provider’s schedule will not be synced
  • hide_in_availability: Whether provider is hidden from availability results (boolean, defaults to false)
    • false: Provider appears in /v1/availability endpoint results (default behavior)
    • true: Provider’s schedule is synced but hidden from availability results
    • Use case: Set to true when you want to continue syncing a provider’s schedule (for reporting/historical purposes) but don’t want them to appear as available for new appointments
    • Important: For a provider to appear in availability, BOTH conditions must be true:
      1. active must be true (schedule is being synced)
      2. hide_in_availability must be false (not explicitly hidden)

​
Schedule Structure

  • Day: Specifies which day of the week the schedule applies to
  • Shifts: Array of work periods with:
    • Start/end times using 24-hour format. Times are in the clinic’s EMR timezone.
    • Facility information (name and ID)
    • Date range when the schedule is active (start date and optional end date. If there is no end date then the shift is active indefinitely).
  • Visit Type Rules (optional):
    • Pre-allocated slots for specific appointment types
    • Each slot has its own start/end times
    • Includes description and total allowed appointments
  • Recurrence (optional):
    • Defines repeating patterns (e.g., “every 2 weeks”)
    • Contains start date and interval information
    • Allows for schedules that don’t occur every week

Authorizations

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

Query Parameters

​
ehr_id
string

Optional exact-match filter on the provider's EHR-native identifier; returns just that provider when supplied.

Example:

"provider-123"

​
page
integer
default:1

Page number. Every provider is returned on one page. Accepted, but no EMR uses it, so it has no effect.

Required range: x >= 1
Example:

1

​
page_size
integer

Results per page. Every provider is returned on one page. Accepted, but no EMR uses it, so it has no effect.

Required range: x >= 1
Example:

100

Response

Providers for the account

​
success
boolean
required
Example:

true

​
providers
object[]
required
Example: