Skip to main content

Test Users

You can test 1-Click Health with mock data in Sandbox, using either random inputs or our dedicated test users below.

These test users are keyed on first name, last name, and birth date. Birth date is the unique input that distinguishes one test user from another, so always send the documented one. Every test user has plans with real payers (the payer ids work in other systems), and every plan returns the same information whether you use insurance autofill or an eligibility check.

Use Sandbox for Development and Testing

Please do all development work and testing against our Sandbox environment, which returns mock data. You can use our Production environment when you're ready to go live.

What you get back
  • Always: memberId, payer, coverageTypes, serviceTypeCodes, and isMedicare for each plan.
  • With an eligibility check (the Check After Autofill brand setting, checkAfterAutofill: true in the request, or memberId + payer as inputs): also the raw edi_271, the parsed eligibility with every field populated (plan name, group number and name, insurance type codes, member address, benefits, contacts), and network when your brand has Network Rules.
  • At most two plans are returned per lookup.
  • Your brand's Coverage Types and Service Type Codes settings filter plans: see Brand settings that hide test users.

How to Use Test Users​

API​

  1. Access the Dashboard and go the Brand Details page for your brand.
  2. Copy a Sandbox API key for your brand.
  3. Call POST /1-click/health with the test user's info (varies by user).
  4. Receive output data via webhook or by polling the GET /1-click/health endpoint.
Coming from 1-Click Signup?

Every 1-Click Signup test user is Richard Hendricks, born 1989-08-01, so passing its identityUuid to 1-Click Health lands on the main happy path below.


Summary​

important

See the later sections for full details on how each of these test users is designed to be used.

Success​

OutputsBirth DateFirst NameLast Name
Multiple plans (Aetna PPO + UnitedHealthcare HMO), every field populated1989-08-01RichardHendricks
Single plan (Aetna), no insurance type code1990-01-01MonicaHall
Dental plan1988-02-02DineshChugtai
Vision plan1986-03-03JaredDunn
Medical plan + dental plan1979-05-05ErlichBachman
Indeterminate coverage (contact the payer)1992-04-04NelsonBighetti
Cigna plan, Texas1978-09-09RussHanneman
Medicare, 65+, MBI member ID, isMedicare: true1952-03-15PeterGregory
Medicare + Medicaid (dual coverage)1955-11-20JackBarker
Medicare Advantage under a commercial payer1958-07-07RonLaFlamme
Multiple plans (Aetna + UnitedHealthcare)Any other birth dateAny stringAny string

Failure​

OutputsBirth DateFirst NameLast Name
No plans1991-01-01GavinBelson

Eligibility Check​

An eligibility check sends memberId and payer. Which inputs the test user is matched on depends on the user:

Matched on member ID. Send the member ID and payer below; first name, last name and birth date can be anything (they are echoed back in the 271). Every plan in the Success tables works the same way with its own member ID and payer.

OutputsMember IDPayer
Active coverageW345876123Aetna (60054)
Active coverageAny member ID from the Success tablesThat plan's payer
Inactive coverage (coverageStatus: "inactive")INACTIVE60054Aetna (60054)
No coverage (subscriber not found)NOTFOUND001Aetna (60054)

Matched on name and birth date. Send these exactly, with the payer; the member ID can be anything.

OutputsBirth DateFirst NameLast NamePayer
Active coverage1995-08-19BertramGilfoyleBlue Cross Blue Shield of Michigan (00710)
Active coverage1990-01-01BertramGilfoyleAnthem Blue Cross Blue Shield of New York (803)
Active coverage1980-03-03BertramGilfoyleCigna (62308)

Success​

Use these test users to go through successful 1-Click Health flows (where Verified returns health insurance plans). All inputs other than first name, last name, and birth date are optional; the address shown is the one the payer has on file, and it is echoed back in the 271 if you send one.

Multiple Plans​

1989-08-01​

This is our primary test user, Richard Hendricks, and the one every 1-Click Signup test user resolves to. Use him first.

Yes, You Read That Right

This is Richard Hendricks from the show Silicon Valley! 😂

Inputs:

InputValue
Birth Date1989-08-01 (1989-08-02 also works, kept for compatibility)
First NameRichard
Last NameHendricks
Middle Name (optional)Harrison
Address (optional)5320 Newell Rd, Ste 200, Palo Alto, CA 94303
Sex (optional)Male

Outputs:

Plan 1Plan 2
Member IDA484069B231615071
PayerAetna (60054)UnitedHealthcare (87726)
Plan nameAETNA CHOICE POS IIUHC CHOICE PLUS HMO
Coverage typesmedicalmedical
Insurance type codesPR (PPO)HM (HMO)
Group123456 · PIED PIPER778899 · HOOLI
isMedicarefalsefalse
Related entitiesAETNA BEHAVIORAL HEALTH (phone, fax, email)OPTUMRX (phone, URL)

With an eligibility check, the parsed eligibility of plan 1 populates every field of ParsedEdi271: individual and family deductibles with remaining amounts, out-of-pocket maximum, copay, coinsurance, a visit limitation, in-network and out-of-network entries, member address with line 2, and two contacts. See the sample 271 below.

Single Plan​

1990-01-01​

Inputs:

InputValue
Birth Date1990-01-01 (1990-01-02 also works, kept for compatibility)
First NameMonica
Last NameHall
Address (optional)7500 N Glenoaks Blvd, Burbank, CA 91504

Outputs:

Plan 1
Member IDA664048
PayerAetna (60054)
Plan nameAETNA OPEN CHOICE
Coverage typesmedical
Insurance type codesnone (the payer reported no code)
Group654321
isMedicarefalse

Dental and Vision​

1988-02-02​

InputValue
Birth Date1988-02-02
First NameDinesh
Last NameChugtai
Plan 1
Member IDD726687
PayerAetna (60054)
Plan nameAETNA DENTAL PPO
Coverage typesdental
Service type codes35, 23, 24, 25, 26
Group111222 · PIED PIPER

1986-03-03​

InputValue
Birth Date1986-03-03
First NameJared
Last NameDunn
Plan 1
Member IDV726687
PayerAetna (60054)
Plan nameAETNA VISION PREFERRED
Coverage typesvision
Service type codesAL, AM
Group111222 · PIED PIPER
warning

A brand whose Coverage Types setting is Medical only, or whose Service Type Codes do not include 35 / AL, gets "No coverage found" for these two users. See Brand settings that hide test users.

1979-05-05​

Erlich Bachman has a medical plan and a dental plan at two payers, so you can watch the Coverage Types setting remove one of them.

InputValue
Birth Date1979-05-05
First NameErlich
Last NameBachman
Plan 1Plan 2
Member IDA700002B700002
PayerAetna (60054)UnitedHealthcare Dental (52133)
Plan nameAETNA CHOICE POS IIUHC DENTAL PPO
Coverage typesmedicaldental
Insurance type codesPRnone
Group333444 · BACHMANITY333444 · BACHMANITY

Indeterminate Coverage​

1992-04-04​

The payer confirms a plan exists but asks you to call them: eligibility.coverageStatus is indeterminate and eligibility.contacts carries the number.

InputValue
Birth Date1992-04-04
First NameNelson
Last NameBighetti
Plan 1
Member IDA700001
PayerAetna (60054)
Coverage statusindeterminate
ContactsBEHAVIORAL HEALTH CARVE OUT, 800-555-1234
Network (with rules)INDETERMINATE

Cigna​

1978-09-09​

InputValue
Birth Date1978-09-09
First NameRuss
Last NameHanneman
Address (optional)1 Congress Ave, Austin, TX 78701
Plan 1
Member IDU12345678
PayerCigna (62308)
Plan nameCIGNA OPEN ACCESS PLUS
Coverage typesmedical
Insurance type codesPR
Group445566 · THREE COMMA CLUB
StateTX

Medicare and Medicaid​

1952-03-15​

A 65+ user with Original Medicare. The member ID is a Medicare Beneficiary Identifier (MBI), so isMedicare is true. Also reachable by sending "payer": { "id": "VERIFIED_MEDICARE" }.

InputValue
Birth Date1952-03-15
First NamePeter
Last NameGregory
Plan 1
Member ID1EG4TE5MK73
PayerMedicare (MEDICARE)
Plan nameMEDICARE PART A AND PART B
Coverage typesmedical
Insurance type codesMA, MB
isMedicaretrue

1955-11-20​

A 65+ user with Medicare and Medicaid (Medi-Cal). isMedicare is true on the Medicare plan and false on the Medicaid plan; the Medicaid plan carries insurance type code MC.

InputValue
Birth Date1955-11-20
First NameJack
Last NameBarker
Plan 1Plan 2
Member ID7W34Q29JT5091234567A
PayerMedicare (MEDICARE)Medi-Cal (MDCAL)
Plan nameMEDICARE PART A AND PART BMEDI-CAL
Coverage typesmedicalmedical
Insurance type codesMA, MBMC
isMedicaretruefalse

1958-07-07​

A Medicare Advantage plan administered by a commercial payer. The member ID is payer-issued (not an MBI), but the 271 carries insurance type code HN (HMO Medicare Risk), so isMedicare is still true.

InputValue
Birth Date1958-07-07
First NameRon
Last NameLaFlamme
Plan 1
Member ID101234567890
PayerAetna (60054)
Plan nameAETNA MEDICARE ADVANTAGE PPO
Coverage typesmedical
Insurance type codesHN
isMedicaretrue

Any Other Name and Birth Date​

Any first name, last name, and birth date that do not match a test user return two plans with real payers, with your inputs echoed back in the 271. This keeps demos and quick tests easy; use Gavin Belson to test the no-coverage path.

Plan 1Plan 2
Member IDA618095B895002692
PayerAetna (60054)UnitedHealthcare (87726)
Plan nameAETNA CHOICE POS IIUHC CHOICE PLUS HMO
Coverage typesmedicalmedical
Insurance type codesPRHM
Group123456 · PIED PIPER778899 · HOOLI

Failure​

Use this test user to go through an unsuccessful 1-Click Health flow (where Verified does not find health insurance plans).

1991-01-01​

InputValue
Birth Date1991-01-01
First NameGavin
Last NameBelson
Address (optional)3300 Palos Verdes Dr W, Rancho Palos Verdes, CA 90275

Outputs: the 1ClickHealthEntity has status FAILED and errors: [{ "message": "No coverage found" }].


Eligibility Check​

To test an eligibility check instead of insurance autofill, send memberId and payer (for example Richard Hendricks with memberId: "A484069" and payer: { "id": "60054" }). Include checkAfterAutofill: true, or have the brand setting on, to receive edi_271 and eligibility.

How a test user is matched depends on the user:

Matched on member ID. First name, last name and birth date can be anything; they are echoed back in the 271.

Member IDPayerResult
W345876123Aetna (60054)Active coverage, AETNA CHOICE POS II
Any member ID from the Success sectionThat plan's payerActive coverage, the same plan
INACTIVE60054Aetna (60054)Inactive coverage, AETNA CHOICE POS II terminated 2023-12-31 (coverageStatus: "inactive")
NOTFOUND001Aetna (60054)No coverage found (subscriber not found)

Matched on name and birth date. Send these exactly; the member ID can be anything.

First NameLast NameBirth DatePayerResult
BertramGilfoyle1995-08-19Blue Cross Blue Shield of Michigan (00710)Active coverage
BertramGilfoyle1990-01-01Anthem Blue Cross Blue Shield of New York (803)Active coverage
BertramGilfoyle1980-03-03Cigna (62308)Active coverage

Any other member ID and payer returns "No coverage found".

An inactive plan is still a result: the payer answered about the member you named, so the request succeeds and the plan comes back with eligibility.coverageStatus set to "inactive" (and the termination date in eligibility.plan.terminationDate). Only an unknown member fails with "No coverage found". Insurance autofill never returns inactive plans.


Brand Settings That Hide Test Users​

Two brand settings filter plans after the payer answers, so a test user can legitimately return "No coverage found" on your brand:

  • Coverage Types set to Medical only removes the dental and vision plans: Dinesh Chugtai and Jared Dunn return no coverage, Erlich Bachman returns his medical plan only.
  • Service Type Codes narrow the question. A plan is dropped when every specific code it answers is outside your list; the plan-level code 30 never filters. With the default (30) every user returns; with 30 and 98 the medical users return and the dental / vision users do not; with 30 and 35 only the dental plans return.

Network Rules​

Network Rules belong to your brand, not to the test user, and the network object is only returned when an eligibility check ran. To see every outcome, create these rules on your Sandbox brand in the Dashboard:

RuleStatusTest users it matches
Payer equals Aetna (V404110) and Insurance Type Codes include PRIn NetworkRichard Hendricks (Aetna), Erlich Bachman (Aetna)
Payer equals UnitedHealthcare (V816685)Out of NetworkRichard Hendricks (UnitedHealthcare)
Payer equals Cigna (V253146) and State equals TXIn NetworkRuss Hanneman
Insurance Type Codes include MA, MB, HNIn NetworkPeter Gregory, Jack Barker (Medicare), Ron LaFlamme
Insurance Type Codes include MC, notes "Self-pay"Out of NetworkJack Barker (Medi-Cal)
Insurance Type Codes include "No insurance type code"IndeterminateMonica Hall, Nelson Bighetti, Dinesh Chugtai, Jared Dunn, Erlich Bachman (dental)
(optional) Group Name includes HOOLIIn NetworkRichard Hendricks (UnitedHealthcare): ties with the UnitedHealthcare rule, the two disagree, so the result is INDETERMINATE with both rules listed

Results come back ordered in network, then indeterminate, then out of network, so Richard Hendricks returns his Aetna plan first and Jack Barker his Medicare plan first.


Sample 271​

The raw edi_271 returned for Richard Hendricks' Aetna plan on an eligibility check, one segment per line for readability (the API returns it as one string). Its parsed form is the ParsedEdi271 object.

ISA*00* *00* *ZZ*60054 *ZZ*Verified *260930*1015*^*00501*000000001*0*P*:~
GS*HB*60054*Verified*20260930*1015*1*X*005010X279A1~
ST*271*0001*005010X279A1~
BHT*0022*11*3E1F2A9C*20260930*101500~
HL*1**20*1~
NM1*PR*2*AETNA*****PI*60054~
PER*IC**TE*8005550154*UR*WWW.AETNA.COM~
HL*2*1*21*1~
NM1*1P*2*YOUR PROVIDER NAME*****XX*1234567890~
HL*3*2*22*0~
TRN*2*9260930101500001*9012345678~
NM1*IL*1*HENDRICKS*RICHARD*H***MI*A484069~
REF*6P*123456*PIED PIPER~
N3*5320 NEWELL RD*STE 200~
N4*PALO ALTO*CA*94303~
DMG*D8*19890801*M~
INS*Y*18*001*25~
DTP*291*RD8*20260101-20261231~
DTP*346*D8*20260101~
EB*1*IND*30^1^33^47^86^88^98^MH^UC*PR*AETNA CHOICE POS II~
EB*C*IND*30*PR*AETNA CHOICE POS II*23*1500*****Y~
EB*C*IND*30*PR*AETNA CHOICE POS II*29*750*****Y~
EB*C*FAM*30*PR*AETNA CHOICE POS II*23*3000*****Y~
EB*G*IND*30*PR*AETNA CHOICE POS II*23*8000*****Y~
EB*G*IND*30*PR*AETNA CHOICE POS II*29*6200*****Y~
EB*B*IND*98*PR*AETNA CHOICE POS II*27*30*****Y~
EB*A*IND*98*PR*AETNA CHOICE POS II***0.2****Y~
EB*F*IND*33*PR*AETNA CHOICE POS II*23***VS*20**Y~
EB*C*IND*30*PR*AETNA CHOICE POS II*23*3000*****N~
EB*A*IND*98*PR*AETNA CHOICE POS II***0.4****N~
EB*1*IND*MH*PR*AETNA CHOICE POS II~
LS*2120~
NM1*X3*2*AETNA BEHAVIORAL HEALTH~
PER*IC**TE*8005550143*FX*8005550144*EM*MEMBERS@AETNABH.COM~
LE*2120~
MSG*PRE-CERTIFICATION REQUIRED FOR INPATIENT ADMISSIONS~
SE*35*0001~
GE*1*1~
IEA*1*000000001~