{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2026-08-31T10:31:07.839963",
"person": {
"id": "3605eec5-940f-4d54-9d48-da1cffe940ac",
"first_name": "John",
"last_name": "Doe",
"ssn": "XXXXX1234",
"created_at": "2025-01-15T12:00:00Z",
"middle_name": "Michael",
"phone_number": "+17075489914",
"email": "johndoe@example.com",
"date_of_birth": "1990-01-15",
"gender": "M",
"marital_status": "married",
"suffix": "Jr.",
"title": "Mr.",
"updated_at": "2025-01-15T12:00:00Z",
"dockets": [],
"liens": [],
"watchlist_hits": []
},
"__event__": {
"type": "PersonSearch.updated",
"origin": "api"
},
"updated_at": "2026-08-31T10:31:07.839973",
"reference_id": "Search1234",
"tin_matched": true,
"error": "RuntimeError The Search could not be completed.",
"warnings": "IRS Validation is unavailable."
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Person search updated
Emitted when a Person search has been updated. E.g. if the IRS was down for tin matching, the search may be updated at a later date with the correct tin_matched result.
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2026-08-31T10:31:07.839963",
"person": {
"id": "3605eec5-940f-4d54-9d48-da1cffe940ac",
"first_name": "John",
"last_name": "Doe",
"ssn": "XXXXX1234",
"created_at": "2025-01-15T12:00:00Z",
"middle_name": "Michael",
"phone_number": "+17075489914",
"email": "johndoe@example.com",
"date_of_birth": "1990-01-15",
"gender": "M",
"marital_status": "married",
"suffix": "Jr.",
"title": "Mr.",
"updated_at": "2025-01-15T12:00:00Z",
"dockets": [],
"liens": [],
"watchlist_hits": []
},
"__event__": {
"type": "PersonSearch.updated",
"origin": "api"
},
"updated_at": "2026-08-31T10:31:07.839973",
"reference_id": "Search1234",
"tin_matched": true,
"error": "RuntimeError The Search could not be completed.",
"warnings": "IRS Validation is unavailable."
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Body
The unique identifier of the search.
The current state of the search.
PENDING, EXECUTING, COMPLETED, FAILED, CANCELLED The datetime the search was created.
"2026-08-31T10:31:07.839963"
The person to search for.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The datetime the search was updated at (generally when the search completed).
"2026-08-31T10:31:07.839973"
The reference ID associated with the search.
"Search1234"
Whether the SSN for this person search matches with the name provided
true
Any errors that occurred.
"RuntimeError The Search could not be completed."
Any warnings that occurred.
"IRS Validation is unavailable."
Response
Successful Response