How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Candid Health

Candid Health Fee Schedules API

The Fee Schedules API from Candid Health — 11 operation(s) for fee schedules.

Documentation Provider Profile APIs.io OpenAPI GitHub

Candid Health Fee Schedules API is one of 53 APIs that Candid Health publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Fee Schedules. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 12 operations across 11 paths, and defines 41 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 10 base URLs: https://pre-api.joincandidhealth.com, https://pre-api-staging.joincandidhealth.com, https://sandbox-pre-api.joincandidhealth.com, https://staging-pre-api.joincandidhealth.com, http://localhost:4000, https://api.joincandidhealth.com, https://api-staging.joincandidhealth.com, https://sandbox-api.joincandidhealth.com, https://staging-api.joincandidhealth.com, http://localhost:5050.

12 operations 11 paths 41 schemas 1 DELETE7 GET3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.joincandidhealth.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Candid Health Fee Schedules API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (OAuthScheme).

  • OAuthScheme — OAuth 2.0 authentication

Paths & Operations 12

Across 11 paths, the API surfaces 12 operations — 1 DELETE, 7 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Fee Schedules 12
GET
/api/fee-schedules/v3/service-line/{service_line_id}/match
Get Match
get_match 2 params → 200404422
GET
/api/fee-schedules/v3/service-line/{service_line_id}/match/{rate_id}
Test Match
test_match 3 params → 200404422
GET
/api/fee-schedules/v3
Get Multi
get_multi 14 params → 200
POST
/api/fee-schedules/v3
Upload a fee schedule (a collection of rates)
upload_fee_schedule 1 param body → 200422
GET
/api/fee-schedules/v3/unique-dimension-values
Get Unique Values For Dimension
get_unique_values_for_dimension 14 params → 200
GET
/api/fee-schedules/v3/{rate_id}/history
Get Rate History
get_rate_history 2 params → 200404
DELETE
/api/fee-schedules/v3/{rate_id}/{version}
Delete a rate
delete_rate 3 params → 200404409
GET
/api/fee-schedules/v3/payer-threshold/default
Get Payer Thresholds Default
get_payer_thresholds_default 1 param → 200
GET
/api/fee-schedules/v3/payer-threshold
Get Payer Thresholds
get_payer_thresholds 2 params → 200
PUT
/api/fee-schedules/v3/payer-threshold/{payer_uuid}
Set Payer Threshold
set_payer_threshold 2 params body → 200404
POST
/api/fee-schedules/v3/hard-delete
Hard delete rates
hard_delete_rates 1 param body → 200
POST
/api/fee-schedules/v3/hard-delete-by-ids
Hard delete rates by IDs
hard_delete_rates_by_ids 1 param body → 200

Schemas 41

The contract defines 41 schemas that model the data the API accepts and returns. The most detailed are type_fee-schedules_v3_DimensionMatch (10 properties), type_fee-schedules_v3_Dimensions (10 properties), type_fee-schedules_v3_OptionalDimensions (10 properties), type_fee-schedules_v3_Rate (6 properties). Each schema is shown below with its type and property counts.

type_commons_PageToken
string
type_fee-schedules_v3_MatchPayer
object
Match information for a payer
3 properties 3 required
type_fee-schedules_v3_RateUpload
type_fee-schedules_v3_MatchDate
object
Match information for date of service
3 properties 2 required
type_fee-schedules_v3_MatchLicenseType
object
Match information for rendering provider license type
3 properties 2 required
type_fee-schedules_v3_MatchResult
object
2 properties 2 required
type_organization-providers_v2_LicenseType
string
type_commons_NetworkType
string
type_fee-schedules_v3_MatchNetworkTypes
object
Match information for network types
3 properties 3 required
type_fee-schedules_v3_MatchFacilityTypeCode
object
Match information for facility type code
3 properties 2 required
type_fee-schedules_v3_MatchPayerPlanGroups
object
Match information for a payer plan
3 properties 3 required
type_fee-schedules_v3_PayerThresholdsPage
object
3 properties 1 required
type_commons_EntityNotFoundErrorMessage
object
1 property 1 required
type_fee-schedules_v3_ThresholdMatch
object
Threshold and dollar amount matching for a service line
4 properties 4 required
type_fee-schedules_v3_RateEntry
object
A rate value in cents for a specific time range. Rate entries can be deactivated, which is set by using the deleterate endpoint. Deactivated rate entries are n…
4 properties 3 required
type_commons_ProcedureModifier
string
type_fee-schedules_v3_DimensionMatch
object
Dimension matching for a service line
10 properties 10 required
type_commons_UserId
string
type_commons_ErrorMessage
string
type_organization-providers_v2_OrganizationProviderId
string
type_fee-schedules_v3_MatchProvider
object
Match information for a billing provider
3 properties 2 required
type_commons_PayerPlanGroupId
string
type_fee-schedules_v3_RatesPage
object
3 properties 1 required
type_fee-schedules_v3_DimensionsPage
object
3 properties 1 required
type_fee-schedules_v3_Dimensions
object
Dimension values that qualify a rate. For the optional dimensions, a null value signifies "all apply". For set-type dimensions, an empty set signifies "all app…
10 properties 10 required
type_fee-schedules_v3_MatchCptCode
object
Match information for a CPT code
3 properties 3 required
type_commons_State
string
type_fee-schedules_v3_MatchModifiers
object
Match information for procedure modifiers
3 properties 3 required
type_fee-schedules_v3_RateUploadWithPossibleErrors
object
3 properties 2 required
type_commons_EntityConflictErrorMessage
object
1 property 1 required
type_commons_ServiceLineId
string
type_fee-schedules_v3_DimensionName
string
The name of a dimension.
type_commons_FacilityTypeCode
string
Box 24B on the CMS-1500 claim form. Line-level place of service is not currently supported. 02 for telemedicine, 11 for in-person. Full list here: https://www.…
type_fee-schedules_v3_OptionalDimensions
object
A dimensions object where all properties are optional.
10 properties 7 required
type_fee-schedules_v3_MatchTestResult
object
2 properties 2 required
type_payers_v3_PayerUuid
string
type_fee-schedules_v3_PayerThreshold
object
Rate thresholds that determine fee schedule rate matching behavior. When a service line is adjudicated by a payer Candid determines if the payer's allowed amou…
3 properties 1 required
type_fee-schedules_v3_Rate
object
A comprehensive rate including the current rate value and all values for historic time ranges. The time ranges specified by each RateEntry are disjoint. A rate…
6 properties 6 required
type_fee-schedules_v3_ValidationError
type_fee-schedules_v3_MatchGeo
object
Match information for state or zip code
4 properties 2 required
type_commons_RateId
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

candid-health-fee-schedules-api-openapi.yml Raw ↑

Other APIs Candid Health publishes across the network.

Candid Health Patient Collections API
AE Profile APIs.io
Candid Health Charge Capture API
AE Profile APIs.io
Candid Health Exports API
AE Profile APIs.io
Candid Health Patients API
AE Profile APIs.io
Candid Health Credentialing API
AE Profile APIs.io
Candid Health Auth API
AE Profile APIs.io
Candid Health Default API
AE Profile APIs.io
Candid Health Diagnoses API
AE Profile APIs.io
Candid Health Appointments API
AE Profile APIs.io
Candid Health Billing Notes API
AE Profile APIs.io
Candid Health Charge Capture Claim Creation API
AE Profile APIs.io
Candid Health Charge Captures API
AE Profile APIs.io
#Fee Schedules
← Back to C APIs
API Details
ID
candid-health:candid-health-fee-schedules-api
Base URL
https://api.joincandidhealth.com
Docs
https://docs.joincandidhealth.com/api-reference/patient-collections
Provider
Candid Health
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=candid-health-fee-schedules-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/candid-health-fee-schedules-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Candid Health Fee Schedules API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.