Skip to main content
POST
/
api
/
eligibility
Submit an eligibility check
curl --request POST \
  --url https://app.shasta.health/api/eligibility \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": {
    "organizationName": "Shasta Medical Group",
    "npi": "1234567890"
  },
  "subscriber": {
    "firstName": "Jane",
    "lastName": "Doe",
    "dateOfBirth": "19800115",
    "memberId": "XYZ123456"
  },
  "encounter": {
    "dateOfService": "20260301",
    "serviceTypeCodes": [
      "30"
    ]
  },
  "tradingPartnerServiceId": "60054"
}
'
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "IN_PROGRESS"
}

Authorizations

​
Authorization
string
header
required

Pass your API key as Key <your-api-key>. Example: Authorization: Key sk_abc123

Body

application/json
​
provider
object
required

The rendering or billing provider.

​
subscriber
object
required

The insurance subscriber.

​
tradingPartnerServiceId
string
required

Payer trading-partner ID. Required.

Minimum string length: 1
Example:

"60054"

​
controlNumber
string

Optional client-supplied control number (up to 9 digits).

​
eligibilitySearchId
string
​
externalPatientId
string

Your internal patient identifier; returned in the response for correlation.

​
dependents
object[]
​
encounter
object

Details about the planned or completed encounter.

​
tradingPartnerName
string
​
portalUsername
string
​
portalPassword
string
​
submitterTransactionIdentifier
string

Response

Eligibility check accepted and queued for processing.

​
id
string
required
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
status
string
required

Current task status.

Example:

"IN_PROGRESS"