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

Candid Health V3 API

The v3 API from Candid Health — 28 operation(s) for v3.

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

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

This API exposes 39 operations across 28 paths, and defines 127 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.

39 operations 28 paths 127 schemas 4 DELETE21 GET4 PATCH8 POST2 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 V3 API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (OAuthScheme).

  • OAuthScheme — OAuth 2.0 authentication

Paths & Operations 39

Across 28 paths, the API surfaces 39 operations — 4 DELETE, 21 GET, 4 PATCH, 8 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

v3 39
GET
/api/contracts/v3/{contract_id}
Get contract
get 2 params → 200404
DELETE
/api/contracts/v3/{contract_id}
Delete contract
delete 2 params → 200422
PATCH
/api/contracts/v3/{contract_id}
Update contract
update 2 params body → 200422
GET
/api/contracts/v3
Get all contracts
get_multi 11 params → 200
POST
/api/contracts/v3
Create contract
create 1 param body → 200
GET
/api/contracts/v3/{contract_id}/providers
Get contract providers
get_contract_providers 4 params → 200404422
POST
/api/contracts/v3/{contract_id}/providers
Add providers to contract
add_contract_providers 2 params body → 200404422
DELETE
/api/contracts/v3/{contract_id}/providers
Remove providers from contract
remove_contract_providers 2 params body → 200404422
GET
/api/contracts/v3/{contract_id}/providers/credentialing
Get contract provider credentialing spans
get_contract_provider_credentialing_spans 4 params → 200404422
POST
/api/contracts/v3/{contract_id}/service-facilities
Create contract service facility
create_contract_service_facility 2 params body → 200422
PATCH
/api/contracts/v3/{contract_id}/service-facilities/{contract_service_facility_id}
Update contract service facility
update_contract_service_facility 3 params body → 200422
GET
/api/exports/v3
Get exports
get_exports 3 params → 200403422503
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
GET
/api/organization-providers/v3/{organization_provider_id}
Get organization provider
get 2 params → 200404
PATCH
/api/organization-providers/v3/{organization_provider_id}
Update organization provider
update 2 params body → 200404422
GET
/api/organization-providers/v3
Get all organization providers
get_multi 10 params → 200
POST
/api/organization-providers/v3
Create organization provider
create 1 param body → 200422
PUT
/api/organization-providers/v3/{organization_provider_id}/attachments
Upload provider attachment
upload_attachment 2 params body → 200
GET
/api/organization-providers/v3/{organization_provider_id}/attachments
List provider attachments
list_attachments 2 params → 200
GET
/api/organization-providers/v3/attachments/download
Download provider attachment
download_attachment 2 params → 200
DELETE
/api/organization-providers/v3/attachments/{attachment_id}
Delete provider attachment
delete_attachment 2 params → 200
GET
/api/payers/v3/{payer_uuid}
Get payer
get 2 params → 200
GET
/api/payers/v3
Get all payers
getAll 4 params → 200
GET
/api/tasks/v3/{task_id}/actions
Get task actions
get_actions 2 params → 200
GET
/api/tasks/v3
Get all tasks
get_multi 16 params → 200422
POST
/api/tasks/v3
Create task
create 1 param body → 200
GET
/api/tasks/v3/{task_id}
Get task
get 2 params → 200403404
PATCH
/api/tasks/v3/{task_id}
Update task
update 2 params body → 200403404422

Schemas 127

The contract defines 127 schemas that model the data the API accepts and returns. The most detailed are type_tasks_v3_Task (20 properties), type_organization-providers_v2_OrganizationProvider (17 properties), type_organization-providers_v3_OrganizationProviderV2 (15 properties), type_organization-providers_v3_OrganizationProviderCreateV2 (14 properties). Each schema is shown below with its type and property counts.

type_commons_EncounterId
string
type_contracts_v3_ContractProviderCredentialingPage
object
3 properties 1 required
type_contracts_v2_AuthorizedSignatoryUpdate
type_contracts_v3_ContractCreateUnion
type_commons_UnprocessableEntityErrorMessage
object
1 property
type_fee-schedules_v3_DimensionName
string
The name of a dimension.
type_contracts_v3_ContractServiceFacility
object
4 properties 4 required
type_organization-service-facilities_v2_OrganizationServiceFacilityId
string
type_fee-schedules_v3_OptionalDimensions
object
A dimensions object where all properties are optional.
10 properties 7 required
type_contracts_v3_ContractServiceFacilityBase
object
2 properties 2 required
type_fee-schedules_v3_MatchTestResult
object
2 properties 2 required
type_fee-schedules_v3_PayerThresholdsPage
object
3 properties 1 required
type_fee-schedules_v3_MatchLicenseType
object
Match information for rendering provider license type
3 properties 2 required
type_identifiers_IdentifierCreate
object
3 properties 2 required
type_contracts_v3_RenderingProviderid
string
type_credentialing_v2_ProviderCredentialingSpan
object
13 properties 8 required
type_contracts_v2_ContractStatus
string
type_contracts_v2_InsuranceTypes
type_commons_RemovableDateRangeOptionalEnd
type_contracts_v2_ContractIsLinkedToFeeScheduleError
object
1 property 1 required
type_commons_NetworkType
string
type_identifiers_IdentifierId
string
type_commons_Date
string
ISO 8601 date; formatted YYYY-MM-DD (i.e. 2012-02-01)
type_identifiers_UpdatableIdentifier
type_organization-providers_v3_OrganizationProviderCreateV2
object
14 properties 6 required
type_contracts_v3_ContractUnion
type_fee-schedules_v3_MatchResult
object
2 properties 2 required
type_commons_UnauthorizedErrorMessage
object
1 property
type_fee-schedules_v3_MatchFacilityTypeCode
object
Match information for facility type code
3 properties 2 required
type_commons_SortDirection
string
type_contracts_v3_ContractServiceFacilityId
string
type_pipeline-commons_ConfigurableRuleId
string
type_fee-schedules_v3_MatchDate
object
Match information for date of service
3 properties 2 required
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_tasks_v3_TaskPage
object
3 properties 1 required
type_tasks_v3_TaskNote
object
5 properties 5 required
type_organization-providers_v3_ProviderAttachmentId
string
type_commons_ProcedureModifier
string
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_identifiers_IdentifierCode
string
type_commons_Regions
type_contracts_v3_ContractProviderCount
object
1 property 1 required
type_exports_v3_GetExportsResponse
object
4 properties 4 required
type_commons_DateRangeOptionalEnd
object
2 properties 1 required
type_organization-providers_v2_EmploymentStatus
string
type_organization-providers_v3_ProviderAttachment
object
4 properties 4 required
type_contracts_v2_ContractInvalidExpirationDateError
object
1 property 1 required
type_contracts_v3_ContractingProviderId
string
type_identifiers_IdentifierValue
type_credentialing_v2_ProviderCredentialingSpanId
string
type_contracts_v2_AuthorizedSignatory
object
6 properties
type_fee-schedules_v3_MatchPayerPlanGroups
object
Match information for a payer plan
3 properties 3 required
type_fee-schedules_v3_MatchGeo
object
Match information for state or zip code
4 properties 2 required
type_commons_ServiceLineId
string
type_fee-schedules_v3_DimensionMatch
object
Dimension matching for a service line
10 properties 10 required
type_organization-providers_v2_OrganizationProviderAddress
object
2 properties 2 required
type_fee-schedules_v3_MatchProvider
object
Match information for a billing provider
3 properties 2 required
type_tasks_commons_TaskStatus
string
type_organization-providers_v2_ProviderType
string
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_organization-providers_v2_AddressType
string
type_fee-schedules_v3_ThresholdMatch
object
Threshold and dollar amount matching for a service line
4 properties 4 required
type_credentialing_v2_CredentialingSpanStatus
string
Stage of a credentialing span in the credentialing workflow.
type_tasks_v3_TaskActionType
string
type_pipeline-commons_RuleId
string
type_fee-schedules_v3_RateUploadWithPossibleErrors
object
3 properties 2 required
type_fee-schedules_v3_ValidationError
type_organization-providers_v2_OrganizationProviderSortOptions
string
type_tasks_v3_TaskSortOptions
string
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_organization-providers_v2_OrganizationProvider
object
17 properties 7 required
type_contracts_v3_ContractId
string
type_tasks_v3_TaskUpdateV3
object
3 properties
type_contracts_v3_ContractWithProvidersUnion
type_commons_ErrorMessage
string
type_contracts_v2_RegionsUpdate
type_organization-providers_v3_ProviderAttachmentResponse
object
1 property 1 required
type_contracts_v3_ContractUpdateUnion
type_contracts_v3_ContractProvidersPage
object
3 properties 1 required
type_fee-schedules_v3_RatesPage
object
3 properties 1 required
type_contracts_v3_AddContractProvidersResponse
object
3 properties 3 required
type_commons_PageToken
string
type_contracts_v3_ContractsPage
object
3 properties 1 required
type_commons_UserId
string
type_commons_PayerPlanGroupId
string
type_tasks_v3_TaskActions
object
1 property 1 required
type_fee-schedules_v3_MatchModifiers
object
Match information for procedure modifiers
3 properties 3 required
type_commons_OrganizationId
string
type_fee-schedules_v3_MatchNetworkTypes
object
Match information for network types
3 properties 3 required
type_contracts_v3_ContractType
string
type_tasks_v3_TaskCreateV3
object
7 properties 4 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_organization-providers_v3_OrganizationProviderUpdateV2
object
14 properties
type_commons_StreetAddressLongZip
object
6 properties 5 required
type_commons_UpdatesDisabledDueToExternalSystemIntegrationErrorMessage
object
1 property
type_contracts_v3_ContractProviderCredentialing
object
A rendering provider with their credentialing spans scoped to the contract's contracting provider and payer.
2 properties 2 required
type_commons_TaskId
string
type_contracts_v2_ContractSortField
string
type_tasks_v3_TaskActionExecutionMethod
type_identifiers_Identifier
object
4 properties 3 required
type_commons_EntityConflictErrorMessage
object
1 property 1 required
type_fee-schedules_v3_MatchCptCode
object
Match information for a CPT code
3 properties 3 required
type_payers_v3_Payer
object
8 properties 3 required
type_fee-schedules_v3_DimensionsPage
object
3 properties 1 required
type_commons_EntityNotFoundErrorMessage
object
1 property 1 required
type_tasks_v3_TaskAction
object
3 properties 3 required
type_contracts_v2_DateUpdate
type_commons_InsuranceTypeCode
string
Code identifying the type of insurance policy within a specific insurance program (X12 008020 Element 1336)
type_organization-providers_v2_OrganizationProviderId
string
type_commons_State
string
type_tasks_v3_TaskAssignment
object
2 properties 1 required
type_commons_WorkQueueId
string
type_fee-schedules_v3_RateUpload
type_fee-schedules_v3_MatchPayer
object
Match information for a payer
3 properties 3 required
type_tasks_v3_TaskUpdatedToDeprecatedStatusErrorType
object
1 property
type_organization-providers_v3_OrganizationProviderPageV2
object
3 properties 1 required
type_payers_v3_PayerUuid
string
type_organization-providers_v3_ProviderAttachmentFileType
string
type_commons_TaskAssignmentId
string
type_tasks_v3_Task
object
20 properties 15 required
type_tasks_commons_TaskCategory
string
type_payers_v3_PayerPage
object
3 properties 1 required
type_commons_TaskNoteId
string
type_tasks_commons_TaskType
string
type_organization-providers_v2_LicenseType
string
type_organization-providers_v3_OrganizationProviderV2
object
15 properties 7 required
type_commons_RateId
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

candid-health-v3-api-openapi.yml Raw ↑

Other APIs Candid Health publishes across the network.

Candid Health Patient Collections API
Candid Health Charge Capture API
Candid Health Exports API
Candid Health Patients API
Candid Health Credentialing API
Candid Health Auth API
Candid Health Default API
Candid Health Diagnoses API
Candid Health V1 API
Candid Health V2 API
Candid Health V4 API
Where this information came from

This is an independent, third-party profile of Candid Health V3 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.