Skip to content

Spousal Profile

Resource representing a user's spouse's personal and contact information.

The Spousal Profile resource contains sensitive personal information about a user's spouse, including their identification details, contact information, and occupation.

Endpoints

MethodUrl
GET/v1.0/users/:user_id/spousal-profile
PUT/v1.0/users/:user_id/spousal-profile
POST/v1.0/jobs/:job_id/checklist/:supporting_item_id/provide-spousal-info
GET/v1.0/jobs/:job_id/spousal-profile

Properties

id
•
string

Unique identifier of the profile.

version
•
number

Version number of the profile. Any update increments this number.

owner_user_id
•
string

ID of the user that owns the profile.

create_time
•
string

Timestamp when the profile was created.

update_time
•
string

Timestamp when the profile was last updated.

occupation
•
string

The spouse's occupation.

personal_info
•
PersonalInfo

Object containing the spouse's personal information. See the personal info object.

contact_info
•
ContactInfo

Object containing the spouse's contact details. See the contact info object.

json
Copied
1{
2 "id": "3b31f309-93ad-463a-ad1d-c39cac1c0a3d",
3 "version": 1,
4 "owner_user_id": "550e8400-e29b-41d4-a716-446655440000",
5 "create_time": "2024-01-01T00:00:00Z",
6 "update_time": "2024-01-01T00:00:00Z",
7 "occupation": "Teacher",
8 "personal_info": {
9 "first_name": "Jane",
10 "middle_initial": "M",
11 "last_name": "Doe",
12 "date_of_birth": "01/01/1991",
13 "personal_taxpayer_identification_number": "XXX-XX-6789"
14 },
15 "contact_info": {
16 "email": "jane.doe@example.com",
17 "phone_number": "+1-555-555-5556",
18 "address": {
19 "address_line_1": "123 Main St",
20 "address_line_2": "Apt 4B",
21 "city": "Miami",
22 "region": "FL",
23 "postal_code": "33134",
24 "country": "United States"
25 }
26 }
27}

Personal Info

first_name
•
string
required

The spouse's first name.

middle_initial
•
string

The spouse's middle initial.

last_name
•
string
required

The spouse's last name.

date_of_birth
•
string

The spouse's date of birth (MM/DD/YYYY).

personal_taxpayer_identification_number
•
string

The spouse's SSN or ITIN. This value may be redacted when retrieving a profile.

Contact Info

email
•
string

The email address.

phone_number
•
string

The phone number. This will be formatted to include country code if not already included.

address
•
PhysicalAddress

The physical contact address. See the physical address object.

Physical Address

address_line_1
•
string

First line of the address.

address_line_2
•
string

Second line of the address.

city
•
string

The city.

region
•
string

The region (state/province/territory).

postal_code
•
string

The postal code.

country
•
string

The country.

Last updated on March 6, 2026