Enrollees

Create Override Check-In

Confirm an HMO-verified check-in for an enrollee at a provider.

Note: This feature is only available to HMOs/Insurers.

This endpoint is the HMO's own check-in method. Calling it asserts that the HMO has independently confirmed or verified the enrollee through their own channels and is recording that confirmation as a valid check-in for the enrollee at the specified provider.

The resulting check-in is recorded with auth_type = Override, alongside the other verification methods (OTP, facial recognition, fingerprint). Receiving this request is the HMO's confirmation; no further approval step is required. The reason field captures the HMO's verification context for audit.

Same-day idempotency: if a check-in already exists for the (enrollee, provider, today), the existing check-in is returned with HTTP 200 and no new records are created.

This request will succeed when:

  • the enrollee belongs to the authenticated Insurer/HMO
  • the provider is linked to the authenticated Insurer/HMO
  • check-in is enabled for the Insurer/HMO
  • the HMO check-in API feature is enabled for the Insurer/HMO
post/v1/enrollees/{enrollee_id}/override-check-ins

Request

  • Base URL: https://api.health.curacel.co/api
  • URL: https://api.health.curacel.co/api/v1/enrollees/{enrollee_id}/override-check-ins
  • Auth: HTTP bearer

Path parameters

enrollee_idinteger required

The ID of the enrollee the override check-in is for.

Request body

provider_idinteger required

The ID of the provider the check-in is being recorded against. The provider must be linked to the authenticated Insurer/HMO.

reasonstring required

Free-text context describing how the HMO verified the enrollee (for example, the verification method used, a reference number, or the staff member that confirmed). Stored on the override record for audit.

Response

An existing same-day check-in was returned. No new records were created.

Changes

No recorded changes to this operation across all 1 revision of this API.