# Candid Health V2 API

**Canonical:** https://apis.io/apis/candid-health/candid-health-v2-api/  
**Provider:** Candid Health — https://apis.io/providers/candid-health/  
**Base URL:** https://api.joincandidhealth.com  
**Documentation:** https://docs.joincandidhealth.com/api-reference/patient-collections

Candid Health V2 API is one of 12 APIs that [Candid Health](https://apis.io/providers/candid-health/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include v2. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The v2 API from Candid Health — 25 operation(s) for v2.

## Operations (43)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/billing_notes/v2` | Create billing note |
| DELETE | `/api/billing_notes/v2/{billing_note_id}` | Delete billing note |
| PATCH | `/api/billing_notes/v2/{billing_note_id}` | Update |
| GET | `/api/contracts/v2/{contract_id}` | Get contract |
| DELETE | `/api/contracts/v2/{contract_id}` | Delete contract |
| PATCH | `/api/contracts/v2/{contract_id}` | Update contract |
| GET | `/api/contracts/v2` | Get all contracts |
| POST | `/api/contracts/v2` | Create contract |
| POST | `/api/provider-credentialing-span/v2/facility` | Create facility credentialing span |
| GET | `/api/provider-credentialing-span/v2/facility` | Get all facility credentialing spans |
| GET | `/api/provider-credentialing-span/v2/facility/{facility_credentialing_id}` | Get facility credentialing span |
| DELETE | `/api/provider-credentialing-span/v2/facility/{facility_credentialing_id}` | Delete facility credentialing span |
| PATCH | `/api/provider-credentialing-span/v2/facility/{facility_credentialing_id}` | Update facility credentialing span |
| POST | `/api/provider-credentialing-span/v2` | Create provider credentialing span |
| GET | `/api/provider-credentialing-span/v2` | Get all provider credentialing spans |
| GET | `/api/provider-credentialing-span/v2/{provider_credentialing_id}` | Get provider credentialing span |
| DELETE | `/api/provider-credentialing-span/v2/{provider_credentialing_id}` | Delete provider credentialing span |
| PATCH | `/api/provider-credentialing-span/v2/{provider_credentialing_id}` | Update provider credentialing span |
| GET | `/api/eligibility/v2/availity` | Submit encounter eligibility check (Availity) |
| POST | `/api/eligibility/v2/availity` | Submit encounter eligibility check (Availity Post) |
| PATCH | `/api/encounter-providers/v2/{encounter_id}` | Update Referring Provider |
| PATCH | `/api/encounter-providers/v2/{encounter_id}/initial-referring-provider` | Update Initial Referring Provider |
| DELETE | `/api/encounter-providers/v2/{encounter_id}/initial-referring-provider` | Delete Initial Referring Provider |
| PATCH | `/api/encounter-providers/v2/{encounter_id}/supervising-provider` | Update Supervising Provider |
| DELETE | `/api/encounter-providers/v2/{encounter_id}/supervising-provider` | Delete Supervising Provider |
| PATCH | `/api/encounter-providers/v2/{service_line_id}/ordering-provider` | Update Ordering Provider |
| DELETE | `/api/encounter-providers/v2/{service_line_id}/ordering-provider` | Delete Ordering Provider |
| POST | `/api/encounter-providers/v2/{encounter_id}/create-referring-provider` | Create Referring Provider |
| POST | `/api/encounter-providers/v2/{encounter_id}/create-initial-referring-provider` | Create Initial Referring Provider |
| POST | `/api/encounter-providers/v2/{encounter_id}/create-supervising-provider` | Create Supervising Provider |
| POST | `/api/encounter-providers/v2/{service_line_id}/create-ordering-provider` | Create Ordering Provider |
| DELETE | `/api/encounter-providers/v2/{encounter_id}/referring-provider` | Delete Referring Provider |
| GET | `/api/organization-service-facilities/v2/{organization_service_facility_id}` | Get organization service facility |
| PATCH | `/api/organization-service-facilities/v2/{organization_service_facility_id}` | Update organization service facility |
| DELETE | `/api/organization-service-facilities/v2/{organization_service_facility_id}` | Delete organization service facility |
| GET | `/api/organization-service-facilities/v2` | Get all organization service facilities |
| POST | `/api/organization-service-facilities/v2` | Create organization service facility |
| GET | `/api/organization-service-facilities/v2/external-id/{external_id}` | Get organization service facility by external_id |
| POST | `/api/service-lines/v2` | Create Service Line |
| POST | `/api/service-lines/v2/universal` | Create Professional or Institutional Service Line |
| PATCH | `/api/service-lines/v2/{service_line_id}/universal` | Update service line for encounter that may be institutional or professional. |
| PATCH | `/api/service-lines/v2/{service_line_id}` | Update Service Line |
| DELETE | `/api/service-lines/v2/{service_line_id}` | Delete Service Line |

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/candid-health/refs/heads/main/openapi/candid-health-v2-api-openapi.yml
- **Documentation** — https://docs.joincandidhealth.com/api-reference/eligibility/v-2
- **Documentation** — https://docs.joincandidhealth.com/api-reference/encounters/v-4
- **Documentation** — https://docs.joincandidhealth.com/api-reference/encounters/v-4/get-all
- **APIReference** — https://docs.joincandidhealth.com/api-reference/encounters/v-4/create
- **PostmanCollection** — https://raw.githubusercontent.com/api-evangelist/candid-health/refs/heads/main/collections/candidhealth.postman_collection.json
- **OpenCollection** — https://raw.githubusercontent.com/api-evangelist/candid-health/refs/heads/main/collections/candidhealth.opencollection.json
- **Documentation** — https://docs.joincandidhealth.com/api-reference/eligibility/v-2/submit-eligibility-check
- **APIReference** — https://docs.joincandidhealth.com/api-reference/pre-encounter/coverages/v-1/check-eligibility
- **Documentation** — https://docs.joincandidhealth.com/api-reference/charge-capture/v-1/create
- **Documentation** — https://docs.joincandidhealth.com/api-reference/payers/v-3/get
- **APIReference** — https://docs.joincandidhealth.com/api-reference/fee-schedules/v-3/get-match
- **Documentation** — https://docs.joincandidhealth.com/api-reference/insurance-adjudications/v-1/get
- **Documentation** — https://docs.joincandidhealth.com/api-reference/events/v-1/get

## Other Candid Health APIs (11)

- [Candid Health Patient Collections API](https://apis.io/apis/candid-health/candid-health-patient-collections-api/)
- [Candid Health Charge Capture API](https://apis.io/apis/candid-health/candid-health-charge-capture-api/)
- [Candid Health Exports API](https://apis.io/apis/candid-health/candid-health-exports-api/)
- [Candid Health Patients API](https://apis.io/apis/candid-health/candid-health-patients-api/)
- [Candid Health Credentialing API](https://apis.io/apis/candid-health/candid-health-credentialing-api/)
- [Candid Health Auth API](https://apis.io/apis/candid-health/candid-health-auth-api/)
- [Candid Health Default API](https://apis.io/apis/candid-health/candid-health-default-api/)
- [Candid Health Diagnoses API](https://apis.io/apis/candid-health/candid-health-diagnoses-api/)
- [Candid Health V1 API](https://apis.io/apis/candid-health/candid-health-v1-api/)
- [Candid Health V3 API](https://apis.io/apis/candid-health/candid-health-v3-api/)
- [Candid Health V4 API](https://apis.io/apis/candid-health/candid-health-v4-api/)

## Tags

v2

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/candid-health/candid-health-v2-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/candid-health/.