Candid Health subpackage_patient-refunds.subpackage_patient-refunds/v1 API

The subpackage_patient-refunds.subpackage_patient-refunds/v1 API from Candid Health — 2 operation(s) for subpackage_patient-refunds.subpackage_patient-refunds/v1.

Documentation Provider Profile APIs.io OpenAPI GitHub

Candid Health subpackage_patient-refunds.subpackage_patient-refunds/v1 API is one of 54 APIs that Candid Health publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include subpackage_patient-refunds.subpackage_patient-refunds/v1. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 2 paths, and defines 25 schemas. It is described by OpenAPI 3.1.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.

5 operations 2 paths 25 schemas 1 DELETE2 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification

OpenAPI 3.1.0

API Version

1.0.0

Base URL

https://api.joincandidhealth.com

Authentication

HTTP Bearer

Resource Areas

Authentication & Security 1

Candid Health subpackage_patient-refunds.subpackage_patient-refunds/v1 API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (OAuthScheme).

OAuthScheme — OAuth 2.0 authentication

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

subpackage_patient-refunds.subpackage_patient-refunds/v1 5

GET

/api/patient-refunds/v1

Get patient refunds

get-multi 12 params → 200403422

POST

/api/patient-refunds/v1

Create patient refund

create 1 param body → 200403404422

GET

/api/patient-refunds/v1/{patient_refund_id}

Get patient refund

get 2 params → 200403404

PATCH

/api/patient-refunds/v1/{patient_refund_id}

Update

update 2 params body → 200403404422

DELETE

/api/patient-refunds/v1/{patient_refund_id}

Delete patient refund

delete 2 params → 200403404422

Schemas 25

The contract defines 25 schemas that model the data the API accepts and returns. The most detailed are type_financials:AllocationOverdraftDetail (5 properties), type_financials:AllocationCreate (3 properties), type_financials:ReallocationWouldOverdraftErrorContent (2 properties), type_commons:UnauthorizedErrorMessage (1 property). Each schema is shown below with its type and property counts.

type_financials:InvoiceUpdate

type_commons:EntityNotFoundErrorMessage

object

1 property 1 required

type_financials:AllocationTarget

Allocation targets describe whether the portion of a payment is being applied toward a specific service line, claim, billing provider, or is unallocated.

type_commons:ClaimId

string

type_commons:ProviderId

string

type_commons:EncounterExternalId

string

type_commons:UnauthorizedErrorMessage

object

1 property

type_financials:NoteUpdate

type_commons:AppointmentId

string

type_financials:ReallocationWouldOverdraftErrorContent

object

Error content when a reallocation would cause an account to be overdrafted. Contains both legacy string messages and new structured allocation details.

2 properties 1 required

type_commons:PatientExternalId

string

type_financials:AllocationTargetCreate

Allocation targets describe whether the portion of a payment is being applied toward a specific service line, claim, billing provider, or is unallocated.

type_commons:UnprocessableEntityErrorMessage

object

1 property

type_commons:SortDirection

string

type_commons:EncounterId

string

type_commons:Date

string

ISO 8601 date; formatted YYYY-MM-DD (i.e. 2012-02-01)

type_commons:InvoiceId

string

type_financials:RefundReasonUpdate

type_financials:AllocationEarmarkType

If enabled for your organization, defines how a patient prepayment allocation should be earmarked for future auto-allocation. Earmarks hold the allocation unti…

type_commons:PageToken

string

type_financials:PatientTransactionSource

string

type_financials:AllocationCreate

object

Allocations are portions of payments that are applied to specific resources, known as targets. Each allocation has and amount, defined in cents, and a target.

3 properties 2 required

type_financials:RefundReason

string

type_financials:AllocationOverdraftDetail

object

Structured information about an allocation that would be overdrafted. Provides entity-specific details to display in a table format.

5 properties 5 required

type_commons:ServiceLineId

string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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 subpackage_auth.subpackage_auth/default API

AE Profile APIs.io

Candid Health subpackage_billing-notes.subpackage_billing-notes/v2 API

AE Profile APIs.io

Candid Health subpackage_charge-capture-bundles.subpackage_charge-capture-bundles/v1 API

AE Profile APIs.io

Candid Health subpackage_charge-capture.subpackage_charge-capture/v1 API

AE Profile APIs.io

Candid Health subpackage_contracts.subpackage_contracts/v2 API

AE Profile APIs.io

Candid Health subpackage_contracts.subpackage_contracts/v3 API

AE Profile APIs.io

#subpackage_patient-refunds.subpackage_patient-refunds/v1

← Back to C APIs

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

Candid Health subpackage_patient-refunds.subpackage_patient-refunds/v1 API

Metadata

Authentication & Security 1

Paths & Operations 5

Schemas 25

Specification

Source

API Details

Provider

Explore more

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

Candid Health subpackage_patient-refunds.subpackage_patient-refunds/v1 API

Metadata

Authentication & Security 1

Paths & Operations 5

Schemas 25

Specification

Source

More from Candid Health 12

API Details

Provider

Explore more