# Candid Health V1 API

**Canonical:** https://apis.io/apis/candid-health/candid-health-v1-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 V1 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 v1. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The v1 API from Candid Health — 105 operation(s) for v1.

## Operations (60 of 150)

| Method | Path | Summary |
|---|---|---|
| POST | `/eligibility-checks/v1` | Post |
| POST | `/eligibility-checks/v1/batch` | Batch |
| GET | `/eligibility-checks/v1/batch/{batch_id}` | Poll Batch |
| GET | `/eligibility-checks/v1/payer/search` | Payer Search |
| GET | `/eligibility-checks/v1/recommendation` | Recommendation |
| POST | `/eligibility-checks/v1/recommendation` | Create Recommendation |
| PUT | `/eligibility-checks/v1/recommendation/{recommendation_id}/{version}/vote` | Vote Recommendation |
| GET | `/eligibility-checks/v1/get-multi/` | Get Multi |
| POST | `/eligibility-checks/v1/insurance-discovery` | Insurance Discovery |
| POST | `/eligibility-checks/v1/coordination-of-benefits` | Coordination Of Benefits |
| POST | `/appointments/v1` | Create |
| GET | `/appointments/v1/visits` | Get Visits |
| GET | `/appointments/v1/visits/counts` | Get Counts |
| GET | `/appointments/v1/{id}` | Get |
| GET | `/appointments/v1/{id}/history` | Get History |
| PUT | `/appointments/v1/{id}/{version}` | Update |
| DELETE | `/appointments/v1/{id}/{version}` | Deactivate |
| GET | `/appointments/v1/updates/scan` | Scan |
| POST | `/coverages/v1/` | Create |
| GET | `/coverages/v1/` | Get Multi |
| PUT | `/coverages/v1//{id}/{version}` | Update |
| GET | `/coverages/v1//get-multi-paginated` | Get Multi Paginated |
| GET | `/coverages/v1//{id}` | Get |
| GET | `/coverages/v1//{id}/history` | Get History |
| GET | `/coverages/v1//updates/scan` | Scan |
| POST | `/coverages/v1//batch-update-ppg/{ppg_id}` | Batch Update Ppg |
| POST | `/coverages/v1//{id}/eligibility` | Check Eligibility |
| GET | `/coverages/v1//{id}/eligibility/{check_id}` | Get Eligibility |
| POST | `/images/v1` | Create |
| GET | `/images/v1` | Get Multi |
| GET | `/images/v1/{id}` | Get |
| PUT | `/images/v1/{id}/{version}` | Update |
| DELETE | `/images/v1/{id}/{version}` | Deactivate |
| GET | `/lists/v1/patient` | Get Patient List |
| GET | `/lists/v1/appointment` | Get Appointment List |
| GET | `/notes/v1/{id}` | Get |
| POST | `/notes/v1` | Create |
| PUT | `/notes/v1/{id}/{version}` | Update |
| DELETE | `/notes/v1/{id}/{version}` | Deactivate |
| GET | `/organization-external-providers/v1/{id}` | Get |
| GET | `/organization-external-providers/v1` | Get Multi |
| POST | `/organization-external-providers/v1` | Create |
| PUT | `/organization-external-providers/v1/{id}/{version}` | Update |
| DELETE | `/organization-external-providers/v1/{id}/{version}` | Deactivate |
| GET | `/organization-external-providers/v1/updates/scan` | Scan |
| POST | `/patient-merge/v1` | Create |
| GET | `/patient-merge/v1/status/{mrn_or_id}` | Get Status |
| GET | `/patient-merge/v1/all/{mrn}` | Get All By Mrn |
| DELETE | `/patient-merge/v1/{id}/{version}` | Deactivate |
| GET | `/patient-merge/v1/updates/scan` | Scan |
| POST | `/patients/v1` | Create |
| GET | `/patients/v1` | Search |
| POST | `/patients/v1/with_mrn` | Create With Mrn |
| GET | `/patients/v1/get_multi` | Get Multi |
| GET | `/patients/v1/search_providers` | Search Providers |
| GET | `/patients/v1/{id}` | Get |
| GET | `/patients/v1/mrn/{mrn}` | Get By Mrn |
| GET | `/patients/v1/{id}/history` | Get History |
| GET | `/patients/v1/{id}/snapshot` | Get Coverage Snapshot |
| GET | `/patients/v1/{id}/eligibility-timeline` | Get Eligibility Timeline |

…and 90 more operations. They are listed in full on the page.

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/candid-health/refs/heads/main/openapi/candid-health-v1-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 V2 API](https://apis.io/apis/candid-health/candid-health-v2-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

v1

---

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