Skip to main content
GET
List Patient Policies

Authorizations

X-API-Key
string
header
required

Query Parameters

patient_id
string | null

Filter by patient ID

insurance_id
string | null

Filter by insurance ID

coverage_tier
enum<string> | null

Filter by coverage tier Insurance tier enum matching Prisma

Available options:
primary,
secondary,
tertiary,
quaternary
external_id
string | null

Filter by external ID

q
string | null

Search: member number contains this text (case-insensitive)

expiration_filter
enum<string> | null

Expiration bucket, ANDed with the other filters. 'expiring' = end_date from today through the next 30 days; 'expired' = end_date before today; 'eligibility_stale' = the current verification's eligibility_check_date is set and older than 90 days (its deductible/OOP remaining values are likely outdated). The insurance expirations dashboard's buckets. The windows are the backend's (app.shared.constants.expirations); the frontend only names them.

Available options:
all,
expiring,
expired,
eligibility_stale
start_date_gte
string<date> | null

Coverage starts on or after this date

start_date_lte
string<date> | null

Coverage starts on or before this date

end_date_gte
string<date> | null

Coverage ends on or after this date

end_date_lte
string<date> | null

Coverage ends on or before this date

eligibility_check_status
enum<string> | null

The current verification's eligibility check status (active, inactive, pending) Eligibility check status. Bound to the PG enum "EligibilityStatus" (labels pending, active, inactive, failed) used by eligibility_checks.eligibility_status. payors.eligibility_check_status is a different PG type (eligibility_check_status, no failed) and is declared literally on the Payor model.

Available options:
active,
inactive,
pending,
failed
provider_network_status
enum<string> | null

The current verification's provider network status Provider network status enum matching Prisma @map values

Available options:
unknown,
in_network,
out_of_network
page
integer | null
default:1

Page number (1-based)

Required range: x >= 1
limit
integer | null
default:50

Number of items per page

Required range: 1 <= x <= 100
expand[]
string[] | null

Expand related resources ('insurance', 'patient')

Response

Successful Response

List response for patient policies.

data
PatientPolicy · object[]
required
pagination
Pagination · object
required

Pagination information for list responses.

Fields:

  • has_more: Whether more items exist beyond this page
  • total: Total number of items across all pages
  • page: Current page number (1-based)
  • limit: Number of items per page