Skip to main content
POST
Submit an eligibility verification

Authorizations

Authorization
string
header
required

Service (M2M) access token issued by POST /auth/token using the client_credentials grant. Required scopes, where known, are listed on each operation below.

Scopes

eligibility:write

Body

application/json
subscriber
object
required

The person whose coverage is being checked. The same field name is used on every endpoint here.

payer_id
string
required

The payer to ask. Find it with GET /payers and send its payer_id unchanged.

Maximum string length: 80
Example:

"61101"

date_of_service
string<date>

ISO YYYY-MM-DD; defaults to today. Send a past date for an earlier encounter or a future one for a scheduled visit — neither is refused. The answer is the coverage in force on the date you asked about.

Example:

"2026-08-28"

specialty_code
enum<string>

The encounter's specialty. An unrecognised value is a 400 rather than a silently dropped field.

Available options:
ABA,
IOP,
OCT,
PCH,
PHT,
PRC,
PSY,
SLP,
SUD,
UGC,
WMT
Example:

"PSY"

place_of_service_code
string

Two-digit CMS place-of-service code.

Example:

"02"

Response

An identical check from your organization was submitted inside the last five minutes. Its id is returned and no payer call was made.

data
object
required
request_id
string
required
Example:

"c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"