PreEncounterCoveragesV1

Scans up to 100 coverage updates. The since query parameter is inclusive, and the result list is ordered by updatedAt ascending.

Polling Pattern: To continuously poll for updates without gaps:

  1. Make your initial request with a since timestamp (e.g., since=2020-01-01T13:00:00.000Z)
  2. The API returns up to 100 coverage records, sorted by updated_at ascending
  3. Find the updated_at value from the last record in the response
  4. Use that updated_at value as the since parameter in your next request
  5. Repeat steps 2-4 to ingest updates until you receive an empty list

Important Notes:

  • The since parameter is inclusive, so you may receive the last record from the previous batch again (you can deduplicate by ID and version)
  • All coverage records include updated_at, id, version, deactivated, and updating_user fields for tracking changes
  • Timestamps have millisecond resolution for precise ordering
get/coverages/v1/updates/scan

Request

  • Base URL: https://api.taigabilling.com
  • URL: https://api.taigabilling.com/coverages/v1/updates/scan
  • Auth: HTTP bearer

Query parameters

sincestring date-time required

Response

idstring uuid required

The unique identifier for a Coverage in the database

organization_idstring required

The unique identifier for an Organization in the database

deactivatedboolean required

True if the object is deactivated. Deactivated objects are not returned in search results but are returned in all other endpoints including scan.

versioninteger required

The version of the object. Any update to any property of an object object will create a new version.

updated_atstring date-time required
updating_user_idstring required

The unique identifier for a User in the database

status'ACTIVE' | 'CANCELLED' | 'DRAFT' | 'ENTERED_IN_ERROR' required

enum to represent the statuses defined at https://build.fhir.org/valueset-fm-status.html

relationship'SELF' | 'SPOUSE' | 'CHILD' | 'COMMON_LAW_SPOUSE' | 'OTHER' required
patientstring required

The unique identifier for a Patient

verifiedboolean required

A boolean indicating if the coverage has been verified by a user.

orconboolean nullable

ORCON (Originator Controlled) - When set to true, the Taiga system will hide this coverage from downstream integrations. Updates made in the Taiga UI will unset this flag. Defaults to false.

auto_update_enabledboolean nullable

Default to true. When set to true, the Taiga system will automatically update this coverage with the latest eligibility check benefits information. Auto update behavior is also set at the eligibilityConfig org level configuration.

previous_appointment_copaysobject nullable

A map of UniversalServiceIdentifier (MD_Visit, Treatment, Tests, Activity) to copay values in cents. This is used to track copay values for each service type to handle OOP max resets correctly.

Changes

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