Provider Directory API Documentation

Version 1.0
API Walkthrough
Getting Started with Postman/cURL
PostMan Collection

Download the Postman collection, import it into Postman. If you need help importing, click on button below to see Postman’s guide.

Download Collection How to import into Postman
Overview

The Provider Directory API enables programmatic access to comprehensive healthcare provider and facility data. This documentation details the API endpoints, request/response formats, and integration guidelines. The API follows RESTful principles and uses JSON for data exchange.

API Collections

The Provider Directory API is organized into three main collections:

  • Lookup: Reference data and code lists
  • Site: Healthcare facility and location information
  • Provider: Healthcare provider details and credentials
Lookup Collection

The Lookup collection provides access to standardized reference data used throughout the Provider Directory system. These endpoints return code lists and lookup values essential for data validation and display.

Available Endpoints

Endpoint Description Try It
/v1/Lookup/schedule-codes Provider schedules and availability codes Live Demo
/v1/Lookup/facility-types Healthcare facility classification codes Live Demo
/v1/Lookup/service-codes Available healthcare services Live Demo
/v1/Lookup/population-served-codes Target population demographics Live Demo
/v1/Lookup/licensure-codes Professional licensure types Live Demo
/v1/Lookup/state-codes US state and territory codes Live Demo
/v1/Lookup/gender-codes Gender identity codes Live Demo
/v1/Lookup/taxonomy Healthcare provider taxonomy codes Live Demo
/v1/Lookup/language-codes Supported languages Live Demo
/v1/Lookup/cultural-cap-codes Cultural competency indicators Live Demo
/v1/Lookup/specialties Medical specialties Live Demo
/v1/Lookup/telehealths Telehealth service options Live Demo
Provider Collection

The Provider Collection enables you to search and filter providers, access provider details, languages, and specialties through a set of RESTful endpoints.

Available Endpoints

Endpoint Description Try It
/v1/Provider/providers

Returns a paginated list of providers.

Query parameters:

  • page (int, required): 1-based page index. Must be >= 1.
  • pageSize (int, required): Number of results per page. Must be a positive integer. The service may apply a maximum.
 Live Demo
/v1/Provider/search

Search providers using optional filters. Omit a parameter or pass it empty to ignore that filter.

Query parameters:

  • FirstName (string): Filter by provider first name.
  • LastName (string): Filter by provider last name.
  • Gender (string): Filter by gender. Use the code values returned by /v1/Lookup/gender-codes.
  • Language (string): Filter by language. Use the code values returned by /v1/Lookup/language-codes.
  • CulturalCapabilityTraining (bool): Filter providers with cultural capability training. Example: T (true) or F(false.
  • Speciality (string): Filter by specialty. Use the code values returned by /v1/Lookup/specialties.
  • ProviderType (string): Filter by provider taxonomy. Use a value from /v1/Lookup/taxonomy.
  • Telehealth (bool): Filter providers offering telehealth. Example: T (true) or F (false).
  • AcceptNewPatient (bool): Filter providers currently accepting new patients. Example: T (true) or F (false).
  • CulturalCapability (string): Filter by cultural capability. Use a value returned by /v1/Provider/provider-languages.
  • Medicare (bool): Filter providers accepting Medicare. Example: T (true) or F (false).
  • CHIP (bool): Filter providers accepting CHIP. Example: T (true) or F (false).
  • TGITraining (bool): Filter providers with TGI training. Example: T (true) or F (false).

Notes:

  • If you need to query multiple codes, you can use the semicolon delimiter (';'). For example, /v1.0/Provider/search?Gender=M;F
 Live Demo
/v1/Provider/{providerId}

Get detailed information for a specific provider.

Path parameter:

  • providerId (int, required): Unique identifier of the provider.

Query parameters: None.

 Live Demo
/v1/Provider/provider-languages

Get list of supported provider languages with fluency levels.

Query parameters: None.

 Live Demo
/v1/Provider/provider-types-list

Get list of provider with related taxonomy codes.

Query parameters: None.

 Live Demo
Site Collection

The Site Collection provides access to healthcare facility information, including locations, services, and schedules. These endpoints enable you to search facilities, retrieve detailed site information, and access related provider associations.

The collection includes endpoints for retrieving site details, searching facilities with various filters, accessing schedules, and managing provider-site relationships. Additional utility endpoints provide quick access to site names and address information.

Available Endpoints

Endpoint Description Try It
/v1/Site/sites

Returns a paginated list of providers.

Query parameters:

  • page (int, required): 1-based page index. Must be >= 1.
  • pageSize (int, required): Number of results per page. Must be a positive integer. The service may apply a maximum.
 Live Demo
/v1/Site/{siteId}

Get detailed information for a specific site.

Path parameter:

  • siteId (int, required): Unique identifier of the site.

Query parameters: None.

 Live Demo
/v1/Site/search

Search sites using optional filters. Omit a parameter or pass it empty to ignore that filter.

Query parameters (all optional unless noted):

  • SiteName (string): Filter by site name.
  • ZipCode (string): Filter by ZIP code.
  • Address (string): Filter by street address.
  • Address2 (string): Filter by secondary address (unit, suite, etc.).
  • City (string): Filter by city name.
  • State (string): Filter by state. Example: AK=Alaska,AL=Alabama,AR=Arkansas,AZ=Arizona,CA=California, etc.
  • WithinDistance (string): Search within specified distance/radius. Distance (in miles) from the given coordinates (requires Latitude and Longitude).
  • ProgramTypes (string): Filter by program types offered at the site. Example: AMHS, CYS, ASO, SUD.
  • IsAdaCompliant (string): Filter sites that are ADA compliant. Example: T (true) or F (false).
  • IsTddTtyAvail (string): Filter sites with TDD/TTY availability. Example: T (true) or F (false).
  • Latitude (string): Latitude coordinate for location-based searches.
  • Longitude (string): Longitude coordinate for location-based searches.
 Live Demo
/v1/Site/site-schedule/{siteId}

Return the schedule that a specific site opens and closes.

Path parameter:

  • siteId (int, required): Unique identifier of the site.

Query parameters: None.

 Live Demo
/v1/Site/provider-site/{siteId}

Get provider-site relationship data for a specific site.

Returns data from the junction table that links providers to sites, showing which providers are associated with the specified site.

Path parameter:

  • siteId (int, required): Unique identifier of the site.

Query parameters: None.

 Live Demo
/v1/Site/all-site-names

Get a list of all site names in the system.

Returns a simple list of site names, useful for populating dropdowns or autocomplete fields.

Path parameters: None.

Query parameters: None.

 Live Demo
/v1/Site/all-site-address

Get a list of all site addresses in the system. This endpoint returns the street address only.

Returns address information for all sites, useful for location-based searches and mapping functionality.

Path parameters: None.

Query parameters: None.

 Live Demo
/v1/Site/all-site-address2

Get an alternative format of all site addresses including building, office, suite information.

Returns secondary address details (building, office, suite numbers) for all sites in the system. This endpoint does not include the street address.

Path parameters: None.

Query parameters: None.

 Live Demo
Quality Management Services (QMS)

Quality Management Services (QMS) is a Behavioral Health Services (BHS) Division that participates in a variety of quality improvement and compliance activities across all divisions.

List of Site Acronyms
OC Links

Call OC Links for yourself, a family member, a friend, a coworker, a neighbor, or anyone else you think could use a little help. Contact OC Links anytime you want and live chat are both available 24 hours a day, 7 days a week.

Notice of Availability of Language Assistance Services

ATTENTION: If you need help in your language call 1-866-308-3074 (TTY: 1-866-308-3073). Aids and services for people with disabilities, like documents in braille and large print, are also available. Call 1-866-308-3074 (TTY: 1-866-308-3073). These services are free of charge.

Contact Us

Orange County Mental Health Plan / Drug Medi-Cal Organized Delivery System - Member Access Line

Phone: 800-723-8641

For TTY/TDD users, call 711

For questions about this resource, contact us by email or visit our About Us page.

OC Navigator

Find help in Orange County by connecting with health, wellness, and other resources.

YOUR RIGHTS UNDER
language-assistance

AQIS

AQISText

List of Site Acronyms

OC Links

Call OC Links for yourself, a family member, a friend, a coworker, a neighbor, or anyone else you think could use a little help. Contact OC Links anytime you want and live chat are both available 24 hours a day, 7 days a week.

Notice of Availability of Language Assistance Services

ATTENTION: If you need help in your language call 1-866-308-3074 (TTY: 1-866-308-3073). Aids and services for people with disabilities, like documents in braille and large print, are also available. Call 1-866-308-3074 (TTY: 1-866-308-3073). These services are free of charge.

Contact Us

Orange County Mental Health Plan / Drug Medi-Cal Organized Delivery System - Member Access Line

Phone: 800-723-8641

For TTY/TDD users, call 711

For questions about this resource, contact us by email or visit our About Us page.

OC Navigator

Find help in Orange County by connecting with health, wellness, and other resources.

YOUR RIGHTS UNDER
language-assistance
logo-occ

© 2026 County of Orange Health Care Agency (Production Build - v5.2.3)

An unhandled error has occurred. Reload 🗙