First Post Request

Call this endpoint first to resolve the subject's identity and generate the KBA questionnaire.

❗️

Search type

Use KBA as the value for the galaxy-search-type header / requestType field.

📘

Minimum fields

FirstName, LastName, and Dob are the baseline for identity resolution. Adding Ssn or AddressLine1 significantly improves match confidence and questionnaire quality.

Identity

Field	Type	Required	Description
FirstName	string	✅	Subject's first name.
MiddleName	string	—	Subject's middle name or initial. Optional; improves match precision.
LastName	string	✅	Subject's last name.
Dob	string	✅	Date of birth. Accepted formats: M/D/YYYY, MM/DD/YYYY, YYYY-MM-DD.
Ssn	string	—	Social Security Number. Full or last 4 digits accepted. Strongly recommended.

Contact & address

Field	Type	Description
AddressLine1	string	Street number and street name (e.g., "123 Main St").
AddressLine2	string	Unit, apartment, or suite designator.
Email	string	Email address associated with the subject.

Quiz configuration

Field	Type	Description
Includes	array	Optional include flags for additional response enrichment. Pass [""] if none.
QuizMode	string	Strict or Loose. Controls the scoring tolerance on Step 2. See Overview for details.

Example request

JSON

{
  "FirstName": "Shawn",
  "MiddleName": "",
  "LastName": "Hazen",
  "AddressLine1": "",
  "AddressLine2": "",
  "Dob": "1/16/1983",
  "Email": "",
  "Ssn": "",
  "Includes": [""],
  "QuizMode": "Loose"
}