Skip to main content
Dojahโ€™s Identity US API helps to verify the address and SSN of an individual

Request

[GET]
{{baseUrl}}/api/v1/us/kyc
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
AuthorizationstringPrivate/secret key. Use <key> not Bearer <key>

Body Parameter

ParameterTypeDescriptionRequired
first_name *stringrequired
last_name *stringrequired
address_street_1 *stringrequired
address_street_2stringoptional
address_citystringConditional: required if zipcode is not present
address_statestringConditional: required if zipcode is not present
address_zip_codestringConditional: not required if city and state are present
identity_number_type *stringโ€œโ€˜SSN9โ€™ or โ€˜SSN4โ€˜โ€œrequired
identity_number *stringrequired

Sample response

Response
{
  "entity": {
    "id-number": 4655255784,
    "results": {
      "key": "result.match",
      "message": "ID Located"
    },
    "summary-result": {
      "key": "id.success",
      "message": "PASS"
    }
  }
}

Response Fields

FieldTypeDescription
entityobjectContains the verification result
entity.id-numbernumberInternal reference ID for the verification request
entity.resultsobjectVerification match details
entity.results.keystringResult key code (e.g., โ€œresult.matchโ€)
entity.results.messagestringHuman-readable result message (e.g., โ€œID Locatedโ€)
entity.summary-resultobjectOverall verification summary
entity.summary-result.keystringSummary key code (e.g., โ€œid.successโ€)
entity.summary-result.messagestringFinal verification outcome (โ€œPASSโ€ or โ€œFAILโ€)