Clever Care Health Plan

Clever Care Health Plan Provider Directory API

Public (rate limited) provider directory resources

GitHub OpenAPI

Documentation

📖
Documentation
https://fhir-portal.clevercarehealthplan.com/api-docs/
📖
APIReference
https://fhir-portal.clevercarehealthplan.com/api-docs/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clevercarehealthplan/refs/heads/main/openapi/clevercarehealthplan-provider-directory-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/clevercarehealthplan-provider-directory-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clevercarehealthplan-provider-directory-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: Clever Care Health Plan FHIR R4 Drug Formulary Provider Directory API
  version: 4.0.1
  description: HL7 FHIR R4 (4.0.1) API for Clever Care Health Plan, implementing the CMS Interoperability and Patient Access final rule (CMS-9115-F). Patient Access resources (Patient, ExplanationOfBenefit, Coverage) are secured with SMART-on-FHIR / OAuth 2.0 and OpenID Connect; Provider Directory and Drug Formulary resources are public and rate limited. ExplanationOfBenefit conforms to the CARIN Blue Button (C4BB) profiles. Served from the "Clever Care FHIR Server" on WSO2 Open Healthcare. This OpenAPI is generated by API Evangelist from the server's published FHIR CapabilityStatement (/r4/metadata) and public api-docs; it is a faithful transcription of the server's declared resources and interactions, not a provider-published spec.
  x-generated-by: api-evangelist-enrichment-pipeline
  x-source: https://fhir.clevercarehealthplan.com/r4/metadata
  x-fhir-version: 4.0.1
  contact:
    name: Clever Care Health Plan
    url: https://clevercarehealthplan.com/fhir-api-developer-resources/
servers:
- url: https://fhir.clevercarehealthplan.com/r4
  description: FHIR R4 production base URL
tags:
- name: Provider Directory
  description: Public (rate limited) provider directory resources
paths:
  /Organization:
    get:
      operationId: searchOrganization
      summary: Search Organization
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/lastUpdated'
      - $ref: '#/components/parameters/profile'
      responses:
        '200':
          $ref: '#/components/responses/Bundle'
  /Organization/{id}:
    get:
      operationId: readOrganization
      summary: Read Organization by id
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/resourceId'
      responses:
        '200':
          $ref: '#/components/responses/Resource'
        '404':
          $ref: '#/components/responses/OperationOutcome'
  /OrganizationAffiliation:
    get:
      operationId: searchOrganizationAffiliation
      summary: Search OrganizationAffiliation
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/lastUpdated'
      - $ref: '#/components/parameters/profile'
      responses:
        '200':
          $ref: '#/components/responses/Bundle'
  /OrganizationAffiliation/{id}:
    get:
      operationId: readOrganizationAffiliation
      summary: Read OrganizationAffiliation by id
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/resourceId'
      responses:
        '200':
          $ref: '#/components/responses/Resource'
        '404':
          $ref: '#/components/responses/OperationOutcome'
  /Practitioner:
    get:
      operationId: searchPractitioner
      summary: Search Practitioner
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/lastUpdated'
      - $ref: '#/components/parameters/profile'
      responses:
        '200':
          $ref: '#/components/responses/Bundle'
  /Practitioner/{id}:
    get:
      operationId: readPractitioner
      summary: Read Practitioner by id
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/resourceId'
      responses:
        '200':
          $ref: '#/components/responses/Resource'
        '404':
          $ref: '#/components/responses/OperationOutcome'
  /PractitionerRole:
    get:
      operationId: searchPractitionerRole
      summary: Search PractitionerRole
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/lastUpdated'
      - $ref: '#/components/parameters/profile'
      responses:
        '200':
          $ref: '#/components/responses/Bundle'
  /PractitionerRole/{id}:
    get:
      operationId: readPractitionerRole
      summary: Read PractitionerRole by id
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/resourceId'
      responses:
        '200':
          $ref: '#/components/responses/Resource'
        '404':
          $ref: '#/components/responses/OperationOutcome'
  /HealthcareService:
    get:
      operationId: searchHealthcareService
      summary: Search HealthcareService
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/lastUpdated'
      - $ref: '#/components/parameters/profile'
      responses:
        '200':
          $ref: '#/components/responses/Bundle'
  /HealthcareService/{id}:
    get:
      operationId: readHealthcareService
      summary: Read HealthcareService by id
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/resourceId'
      responses:
        '200':
          $ref: '#/components/responses/Resource'
        '404':
          $ref: '#/components/responses/OperationOutcome'
  /Location:
    get:
      operationId: searchLocation
      summary: Search Location
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/lastUpdated'
      - $ref: '#/components/parameters/profile'
      responses:
        '200':
          $ref: '#/components/responses/Bundle'
  /Location/{id}:
    get:
      operationId: readLocation
      summary: Read Location by id
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/resourceId'
      responses:
        '200':
          $ref: '#/components/responses/Resource'
        '404':
          $ref: '#/components/responses/OperationOutcome'
  /Endpoint:
    get:
      operationId: searchEndpoint
      summary: Search Endpoint
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/lastUpdated'
      - $ref: '#/components/parameters/profile'
      responses:
        '200':
          $ref: '#/components/responses/Bundle'
  /Endpoint/{id}:
    get:
      operationId: readEndpoint
      summary: Read Endpoint by id
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/resourceId'
      responses:
        '200':
          $ref: '#/components/responses/Resource'
        '404':
          $ref: '#/components/responses/OperationOutcome'
  /InsurancePlan:
    get:
      operationId: searchInsurancePlan
      summary: Search InsurancePlan
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/lastUpdated'
      - $ref: '#/components/parameters/profile'
      responses:
        '200':
          $ref: '#/components/responses/Bundle'
  /InsurancePlan/{id}:
    get:
      operationId: readInsurancePlan
      summary: Read InsurancePlan by id
      tags:
      - Provider Directory
      parameters:
      - $ref: '#/components/parameters/resourceId'
      responses:
        '200':
          $ref: '#/components/responses/Resource'
        '404':
          $ref: '#/components/responses/OperationOutcome'
  /metadata:
    get:
      operationId: getCapabilityStatement
      summary: FHIR CapabilityStatement (server metadata)
      tags:
      - Provider Directory
      responses:
        '200':
          $ref: '#/components/responses/Resource'
components:
  schemas:
    Bundle:
      type: object
      description: FHIR R4 Bundle (type searchset).
      properties:
        resourceType:
          type: string
          enum:
          - Bundle
        type:
          type: string
        total:
          type: integer
        link:
          type: array
          items:
            type: object
            properties:
              relation:
                type: string
              url:
                type: string
        entry:
          type: array
          items:
            type: object
            properties:
              fullUrl:
                type: string
              resource:
                type: object
    OperationOutcome:
      type: object
      description: FHIR R4 OperationOutcome error envelope.
      properties:
        resourceType:
          type: string
          enum:
          - OperationOutcome
        issue:
          type: array
          items:
            type: object
            properties:
              severity:
                type: string
                enum:
                - fatal
                - error
                - warning
                - information
              code:
                type: string
              diagnostics:
                type: string
  parameters:
    id:
      name: _id
      in: query
      description: Filter by logical id of the resource.
      required: false
      schema:
        type: string
    lastUpdated:
      name: _lastUpdated
      in: query
      description: Filter by last modification date (prefixes eq,ne,gt,lt,ge,le).
      required: false
      schema:
        type: string
    profile:
      name: _profile
      in: query
      description: Filter by conformance to a named HL7 profile.
      required: false
      schema:
        type: string
    resourceId:
      name: id
      in: path
      description: Logical id of the resource.
      required: true
      schema:
        type: string
  responses:
    Bundle:
      description: A FHIR searchset Bundle of matching resources.
      content:
        application/fhir+json:
          schema:
            $ref: '#/components/schemas/Bundle'
    OperationOutcome:
      description: A FHIR OperationOutcome describing an error.
      content:
        application/fhir+json:
          schema:
            $ref: '#/components/schemas/OperationOutcome'
    Resource:
      description: A single FHIR resource.
      content:
        application/fhir+json:
          schema:
            type: object
  securitySchemes:
    smartOnFhir:
      type: oauth2
      description: SMART-on-FHIR OAuth 2.0 (PKCE S256), OpenID Connect enabled.
      flows:
        authorizationCode:
          authorizationUrl: https://fhir-portal.clevercarehealthplan.com/oauth2/authorize
          tokenUrl: https://fhir-portal.clevercarehealthplan.com/oauth2/token
          refreshUrl: https://fhir-portal.clevercarehealthplan.com/oauth2/token
          scopes:
            openid: OpenID Connect authentication
            launch/patient: Launch in patient context
            patient/*.cruds: Patient-scoped access to permitted resources
            user/*.cruds: User-scoped access to permitted resources
        clientCredentials:
          tokenUrl: https://fhir-portal.clevercarehealthplan.com/oauth2/token
          scopes:
            openid: OpenID Connect authentication
            user/*.cruds: User-scoped access to permitted resources