SSN Trace is typically the first screening run, and is used to verify that the input SSN exists, determine where and when it was issued, and to compile a list of all known aliases associated with the SSN. This Trace is also used to generate a list of all known addresses recorded by credit agencies for the SSN for the last 7 years.
An SSN Trace may be used to determine which additional jurisdictions should be searched for the candidate, based on the list of known addresses returned.
If the platform detects an issue with the SSN Trace run (data mismatch, absence of data, or inclusion of the SSN on the death master file), Checkr may issue an exception and ask the candidate to either re-enter their SSN or upload other supporting documentation.
Note: Information returned by this search is not a part of the consumer report and may not be used for FCRA purposes, including eligibility determinations under the FCRA
For more information, please see SSN Trace in the Checkr Help Center.
Returns an existing SSN Trace with the input ID.
- Mock serverhttps://docs.checkr.com/_mock/apis/openapi/ssn_traces/{id}
- Staginghttps://api.checkr-staging.com/v1/ssn_traces/{id}
curl -i -X GET \
-u '<username>:<password>' \
'https://docs.checkr.com/_mock/apis/openapi/ssn_traces/{id}'SSN Trace details
URI of the resource.
Status of the screening.
Result of the screening.
Note: The result parameter will always return a null value because this is a non-reportable screening.
Time at which the screening was completed.
Number of seconds the screening took to complete, calculated from created_at to completed_at.
See cancellation reasons section for possible values.
Candidate’s social security number. This value will be redacted in all return calls, except for the last four digits.
If true, the name on the SSN Trace matches the candidate's provided information, but the DOB does not.
If true, the DOB associated with the addresses returned from the SSN Trace matches the candidate's input DOB, but the name does not.
If true, information returned from the SSN Trace does not match any of the candidate’s provided information.
If true, the input SSN has a year of issuance that precedes the candidate's reported year of birth.
If true, the input SSN is listed on the Social Security Administration's “Death Master File”.
If true, another Candidate with same SSN already exists in our system.
{ "id": "e44aa283528e6fde7d542194", "object": "ssn_trace", "uri": "/v1/ssn_traces/539fd88c101897f7cd000001", "status": "complete", "result": null, "created_at": "2014-01-18T12:34:00Z", "completed_at": "2014-01-18T12:35:30Z", "turnaround_time": 90, "cancellation_reason": null, "cancellation_reason_description": null, "ssn": "XXX-XX-4645", "no_data": false, "dob_mismatch": false, "name_mismatch": false, "data_mismatch": false, "thin_file": false, "invalid_issuance_year": false, "death_index": false, "ssn_already_taken": false, "issued_year": 1993, "issued_state": "CA", "addresses": [], "aliases": [] }