Skip to main content

Finding Care Overview

The Finding Care API allows you to search for healthcare providers and facilities based on care categories (specialties, procedures, or conditions) and location. The API provides a two-step workflow for finding care.

Architecture​

The Finding Care API follows a two-step workflow:

  1. Search for Care Categories: Use get-care-categories-v2 to search for available care categories (specialties, procedures, or conditions) based on a query string
  2. Find Nearby Providers: Use find-nearby-care-v2 with the selected care category to find nearby healthcare providers or facilities

Each provider returned includes detailed information such as location, contact details, ratings, insurance acceptance, and more.

Workflow​

The typical workflow for finding care is:

Key Concepts​

Care Categories​

Care categories represent different types of healthcare services:

  • Specialty: Medical specialties (e.g., "Cardiology", "Dermatology", "Pediatrics")
  • Procedure: Medical procedures (e.g., "MRI", "Colonoscopy", "Physical Therapy")
  • Condition: Medical conditions (e.g., "Diabetes", "Hypertension", "Asthma")

Each care category has:

  • care_category_id: Unique identifier for the category
  • care_category_name: Human-readable name
  • care_category_type: Type of category (specialty, procedure, or condition)

Integration Providers​

The API supports comprehensive provider databases with specialties, conditions, and procedures. It supports insurance filtering and accepts new patients filtering. The provider used depends on the domain configuration.

Provider Information​

Each provider returned includes:

  • Basic Information: Name, description, contact details (phone, email, website)
  • Location: Address, city, state, zipcode, latitude, longitude
  • Ratings: Rating and review count
  • Insurance: Accepted insurance plans
  • Additional Details: Languages spoken, gender, accepts new patients, booking links

Facilities vs Providers​

  • Providers: Individual healthcare providers (doctors, specialists)
  • Facilities: Healthcare facilities that perform procedures (hospitals, clinics, imaging centers)

The API automatically returns the appropriate type based on the care category type:

  • Specialty/condition searches return providers
  • Procedure searches return facilities

Use Cases​

The Finding Care API is used to:

  • Search for healthcare providers by specialty, condition, or procedure
  • Find providers near a specific location (zipcode)
  • Filter providers by insurance acceptance
  • Filter providers by whether they accept new patients
  • Get detailed provider information including ratings and contact details

Next Steps​