Create insurance refund | Candid

curl -X POST https://api.joincandidhealth.com/api/insurance-refunds/v1 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "payer_identifier": {
    "type": "payer_info",
    "payer_id": "payer_id",
    "payer_name": "payer_name"
  },
  "amount_cents": 1,
  "allocations": [
    {
      "amount_cents": 1,
      "target": {
        "type": "service_line_by_id",
        "value": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
      }
    },
    {
      "amount_cents": 1,
      "target": {
        "type": "service_line_by_id",
        "value": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
      }
    }
  ]
}'

{
  "insurance_refund_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
  "payer": {
    "payer_uuid": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
    "payer_id": "payer_id",
    "payer_name": "payer_name",
    "availity_payer_name": "availity_payer_name",
    "availity_claims_payer_id": "availity_claims_payer_id",
    "availity_eligibility_id": "availity_eligibility_id",
    "availity_remittance_payer_id": "availity_remittance_payer_id",
    "street_address": {
      "address1": "address1",
      "city": "city",
      "state": "AA",
      "zip_code": "zip_code",
      "zip_plus_four_code": "zip_plus_four_code",
      "address2": "address2"
    }
  },
  "amount_cents": 1,
  "allocations": [
    {
      "amount_cents": 1,
      "target": {
        "type": "service_line",
        "claim_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
        "encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
        "service_line_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
      },
      "earmark": {
        "id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
        "target": {
          "type": "date_of_service",
          "value": "target"
        },
        "amount_earmarked_cents": 1,
        "created_by_allocation_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
      },
      "allocated_on": "2024-01-15T09:30:00Z"
    },
    {
      "amount_cents": 1,
      "target": {
        "type": "service_line",
        "claim_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
        "encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
        "service_line_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
      },
      "earmark": {
        "id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
        "target": {
          "type": "date_of_service",
          "value": "target"
        },
        "amount_earmarked_cents": 1,
        "created_by_allocation_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
      },
      "allocated_on": "2024-01-15T09:30:00Z"
    }
  ],
  "refund_timestamp": "2024-01-15T09:30:00Z",
  "refund_note": "refund_note",
  "refund_reason": "OVERCHARGED"
}

Creates a new insurance refund record and returns the newly created InsuranceRefund object. The allocations can describe whether the refund is being applied toward a specific service line, claim, or billing provider.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Request

This endpoint expects an object.

payer_identifierobjectRequired

amount_centsintegerRequired

allocationslist of objectsRequired

refund_timestampdatetimeOptional

refund_notestringOptional

refund_reasonenumOptional

Allowed values:

Response

This endpoint returns an object.

insurance_refund_idUUID

payerobject

amount_centsinteger

allocationslist of objects

refund_timestampdatetime

refund_notestring

refund_reasonenum

Allowed values:

Errors

403

Unauthorized Error

404

Entity Not Found Error

422

Unprocessable Entity Error