🚧
HTTP Header
The "content-type" in the HTTP header must be set to "application/json", otherwise an HTTP 400 Bad Request response will be returned.

Making a request

The Reverse Name and DOB Append request exactly mimics the logic and data sources used in our batch append service, except it allows the user to make single calls using an API programmatically. Pass simple contact information such as first name, last name, city, state, and full date of birth or fragment of date of birth to look up the US postal address of your search subject.

Notes about Match Logic

City and state are required. The endpoint will return the most recent record matching the input city and state.
First and last names are required. The endpoint will return the most recent record matching the input first and last names.
If a full middle name is passed in, the endpoint will return a record only if the record matches the input middle name.
If the middle name is blank, the endpoint will ignore the middle name when searching.

DOB Format Codes

"M/d/yyyy"
"MM/yyyy"
"yyyy"
"yyyy/MM/dd"
"M/d/yyyy hh:mm:ss tt"
"MMddyyyy"
"MM/dd"
"MM-dd-yyyy"
"yyyy-MM-dd"
"M-d-yyyy"
"MM-dd"

Response Definitions

A single response may include one or more Record elements.

Field name	Type	Description
Address	string	Postal address
City	string	City
State	string	State
PostalCode	string	5-digit postal code

200200

400400

401401

500500