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 Health Care Code Informations API

The Health Care Code Informations API from Candid Health — 1 operation(s) for health care code informations.

Candid Health Health Care Code Informations 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 Health Care Code Informations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 1 path, and defines 46 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.

2 operations 1 paths 46 schemas 1 GET1 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 Health Care Code Informations API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (OAuthScheme).

  • OAuthScheme — OAuth 2.0 authentication

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Health Care Code Informations 2
PUT
/api/health-care-code-informations/v1/{encounter_id}
Update
update 2 params body → 200404422
GET
/api/health-care-code-informations/v1/{encounter_id}
Get All For Encounter
get_all_for_encounter 2 params → 200404

Schemas 46

The contract defines 46 schemas that model the data the API accepts and returns. The most detailed are type_health-care-code-information_v1_HealthCareCodeInformationUpdate (13 properties), type_health-care-code-information_v1_HealthCareCodeInformationGetAllResponse (13 properties), type_health-care-code-information_v1_OccurrenceInformation (5 properties), type_health-care-code-information_v1_ValueInformation (5 properties). Each schema is shown below with its type and property counts.

type_commons_RequestValidationError
object
2 properties 1 required
type_health-care-code-information_v1_ICDCode
string
type_health-care-code-information_v1_AdmittingDiagnosisCodeQualifier
string
type_health-care-code-information_v1_DiagnosisRelatedGroupCodeQualifier
string
type_health-care-code-information_v1_OccurrenceInformationCodeQualifier
string
type_health-care-code-information_v1_OccurrenceSpanInformation
object
This corresponds to the BI code qualifier value.
5 properties 3 required
type_health-care-code-information_v1_TreatmentCodeInformation
object
This corresponds to the TC code qualifier value.
4 properties 2 required
type_health-care-code-information_v1_OtherDiagnosisInformation
object
This corresponds to BF and ABF code qualifier values.
5 properties 2 required
type_health-care-code-information_v1_MSDRGCode
string
type_health-care-code-information_v1_ConditionInformation
object
This corresponds to the BG code qualifier value.
4 properties 2 required
type_health-care-code-information_v1_ExternalCauseOfInjury
object
This corresponds to BN or ABN code qualifier values.
5 properties 2 required
type_commons_EntityNotFoundErrorMessage
object
1 property 1 required
type_health-care-code-information_v1_AdmittingDiagnosis
object
This corresponds to BJ or ABJ code qualifier values.
4 properties 2 required
type_health-care-code-information_v1_HealthCareCodeInformationUpdate
object
13 properties
type_health-care-code-information_v1_PrincipalDiagnosisCodeQualifier
string
type_commons_EncounterId
string
type_health-care-code-information_v1_OtherProcedureInformationCodeQualifier
string
type_health-care-code-information_v1_ConditionCode
string
FL 18-28 - Condition Codes Source: UB-04 Manual 2025, Pages 64-81 (FL18-28, Pages 1-18) Excludes codes designated as "Payer Codes" or "FOR PUBLIC HEALTH DATA R…
type_health-care-code-information_v1_ConditionInformationCodeQualifier
string
type_health-care-code-information_v1_ValueInformation
object
This corresponds to the BE code qualifier value.
5 properties 3 required
type_commons_Decimal
string
String representation of a Decimal that can be parsed by most libraries.
type_health-care-code-information_v1_SetOrClearPrincipalDiagnosis
object
1 property
type_health-care-code-information_v1_PrincipalProcedureInformation
object
This correspond to BBR, BR, and CAH code qualifier values.
5 properties 3 required
type_health-care-code-information_v1_PatientReasonForVisit
object
This corresponds to PR or APR code qualifier values.
4 properties 2 required
type_health-care-code-information_v1_ExternalCauseOfInjuryCodeQualifier
string
type_health-care-code-information_v1_PresentOnAdmissionIndicatorCode
string
type_health-care-code-information_v1_SetOrClearDiagnosisRelatedGroup
object
1 property
type_health-care-code-information_v1_D8Date
string
type_health-care-code-information_v1_OccurrenceCode
string
type_health-care-code-information_v1_RD8Date
object
2 properties 2 required
type_health-care-code-information_v1_PrincipalDiagnosis
object
This corresponds to BK or ABK code qualifier values.
5 properties 2 required
type_health-care-code-information_v1_DiagnosisRelatedGroup
object
This corresponds to DR code qualifier values.
4 properties 2 required
type_health-care-code-information_v1_PrincipalProcedureInformationCodeQualifier
string
type_health-care-code-information_v1_OtherDiagnosisInformationCodeQualifier
string
type_health-care-code-information_v1_OccurrenceSpanCodeQualifier
string
type_health-care-code-information_v1_TreatmentCodeQualifier
string
type_health-care-code-information_v1_HealthCareCodeInformationGetAllResponse
object
13 properties 9 required
type_health-care-code-information_v1_SetOrClearPrincipalProcedureInformation
object
1 property
type_health-care-code-information_v1_OtherProcedureInformation
object
This corresponds to the BBQ or BQ code qualifier values.
5 properties 3 required
type_health-care-code-information_v1_ValueCode
string
type_health-care-code-information_v1_TreatmentCode
string
type_health-care-code-information_v1_OccurrenceSpanCode
string
type_health-care-code-information_v1_OccurrenceInformation
object
This corresponds to the BH code qualifier value.
5 properties 3 required
type_health-care-code-information_v1_PatientReasonForVisitCodeQualifier
string
type_health-care-code-information_v1_SetOrClearAdmittingDiagnosis
object
1 property
type_health-care-code-information_v1_ValueCodeQualifier
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

candid-health-health-care-code-informations-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 Appointments API
Candid Health Billing Notes API
Candid Health Charge Capture Claim Creation API
Candid Health Charge Captures API
Where this information came from

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