Eligibility Fields

Hard checks require patient and payer information. Bridge manages which fields apply for a given session.

Field types

Field	Type	Description
`firstName`	`string`	Patient’s first name
`lastName`	`string`	Patient’s last name
`dateOfBirth`	`Date`	Patient’s date of birth
`memberId`	`string`	Patient’s Member ID
`payer`	`Payer`	Payer object (not the Payer ID alone)
`state`	`UsStateCode`	2 letter US state code

State codes are exported as UsStateCodes and UsStateMap.

Member ID

Whether Member ID is required depends on the Payer. Bridge handles the interaction between Payer selection and Member ID. If the user selects a cardless Payer (eg, Aetna), the field may be hidden.

If certain error codes are returned from an eligibility request, Bridge may show or require Member ID for a second attempt.

Bridge handles deciding whether it’s best to show or require a Member ID, so you don’t have to

React

The useEligibilityInputField hook manages field state within an eligibility session:

1 const {
2   value: FieldType | null
3   setValue: (value: FieldType) => void
4   isVisible: boolean
5   isRequired: boolean
6   isDisabled: boolean
7   isValid: boolean
8 } = useEligibilityInputField("firstName")

See Building Forms for hook usage and examples.

TypeScript

Pass patient fields in the patient object when calling hardEligibility:

1 await bridge.hardEligibility({
2   serviceTypeIds: ["svt_xxx"],
3   state: "CA",
4   patient: {
5     payerId: "pyr_xxx",
6     firstName: "Jane",
7     lastName: "Smith",
8     dateOfBirth: new Date("2000-01-01"),
9     memberId: "W123456789", // optional
10   },
11 })

Hard Check

Full eligibility checks, cost estimates, and provider eligibility