Verification API

API to manage verifications, messages, checkers, devices, and risk scores.
More information: https://trusona.com
Contact Info: support@trusona.com
Version: 2.2.0
BasePath:/api/v1
All rights reserved
http://apache.org/licenses/LICENSE-2.0.html

Access

  1. HTTP Bearer Token authentication (JWT)

Methods

[ Jump to Models ]

Table of Contents

Default

Default

Up 
get /verifications/{id}/devices
Get all devices for a verification (verificationsIdDevicesGet)

Path parameters

id (required)
Path Parameter — default: null

Return type

array[Device]

Example data

Content-Type: application/json
[ {
  "displayHeight" : 1080,
  "dateTime" : "3/18/2025 08:25",
  "browserTimeZone" : "America/Los_Angeles",
  "country" : "United States",
  "city" : "Phoenix",
  "origin" : "example.com",
  "isp" : "COMCAST Cable",
  "latitude" : 33.4484,
  "language" : "en-US",
  "operatingSystem" : "Mac OS X 10.15",
  "platform" : "MacIntel",
  "via" : [ "via", "via" ],
  "createdAt" : "2022-01-01T00:00:00Z",
  "browser" : "Firefox 130.0",
  "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "longitude" : -112.0741,
  "offsetMinutes" : -360,
  "browserHeight" : 1080,
  "ipAddressTimeZone" : "America/Los_Angeles",
  "browserDateTime" : "Tue Mar 18 2025 08:25:06 GMT-0600 (Mountain Daylight Time)",
  "ipAddress" : "192.168.1.1",
  "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:130.0) Gecko/20100101 Firefox/130.0",
  "epochMilliseconds" : 1709000000000,
  "displayWidth" : 1920,
  "browserTimeZoneWithOffset" : "America/Denver (-06.00)",
  "region" : "Arizona",
  "asn" : "AS7922",
  "browserWidth" : 1920
}, {
  "displayHeight" : 1080,
  "dateTime" : "3/18/2025 08:25",
  "browserTimeZone" : "America/Los_Angeles",
  "country" : "United States",
  "city" : "Phoenix",
  "origin" : "example.com",
  "isp" : "COMCAST Cable",
  "latitude" : 33.4484,
  "language" : "en-US",
  "operatingSystem" : "Mac OS X 10.15",
  "platform" : "MacIntel",
  "via" : [ "via", "via" ],
  "createdAt" : "2022-01-01T00:00:00Z",
  "browser" : "Firefox 130.0",
  "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "longitude" : -112.0741,
  "offsetMinutes" : -360,
  "browserHeight" : 1080,
  "ipAddressTimeZone" : "America/Los_Angeles",
  "browserDateTime" : "Tue Mar 18 2025 08:25:06 GMT-0600 (Mountain Daylight Time)",
  "ipAddress" : "192.168.1.1",
  "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:130.0) Gecko/20100101 Firefox/130.0",
  "epochMilliseconds" : 1709000000000,
  "displayWidth" : 1920,
  "browserTimeZoneWithOffset" : "America/Denver (-06.00)",
  "region" : "Arizona",
  "asn" : "AS7922",
  "browserWidth" : 1920
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

List of devices

404

Verification not found
Up 
get /verifications/{id}/document
Get the verification's document (verificationsIdDocumentGet)

Path parameters

id (required)
Path Parameter — default: null

Return type

_verifications__id__document_get_200_response

Example data

Content-Type: application/json
{
  "document" : {
    "lastName" : "lastName",
    "zipCode" : "zipCode",
    "documentType" : "documentType",
    "city" : "city",
    "documentNumber" : "documentNumber",
    "zip4" : "zip4",
    "documentNumberSuffix" : "documentNumberSuffix",
    "expiryDate" : "expiryDate",
    "createdAt" : "2022-01-01T00:00:00Z",
    "middleInitial" : "middleInitial",
    "eyeColor" : "eyeColor",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "state" : "state",
    "issueDate" : "issueDate",
    "height" : "height",
    "updatedAt" : "2022-01-01T00:00:00Z",
    "placeOfBirth" : "placeOfBirth",
    "address2" : "address2",
    "address1" : "address1",
    "sex" : "sex",
    "weight" : "weight",
    "dateOfBirth" : "dateOfBirth",
    "firstName" : "firstName",
    "issuingAuthority" : "issuingAuthority",
    "nationality" : "nationality",
    "middleName" : "middleName",
    "age" : "age"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

The verification's document _verifications__id__document_get_200_response

404

Verification was not found or document is not yet available

410

Document has been removed (occurs when parent verification expires)
Up 
get /verifications/{id}/document/scanned_image
Get the scanned image of the document (verificationsIdDocumentScannedImageGet)

Path parameters

id (required)
Path Parameter — default: null

Return type

ScannedImage

Example data

Content-Type: application/json
{
  "data" : "UjBsR09EbGhBUUFCQUlBQUFBQUFBUC8vL3lINUJBRUFBQUFBTEFBQUFBQUJBQUVBQUFJQlJBQTc="
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

The scanned document image ScannedImage

404

Verification was not found or document does not have an available scanned image

410

Scanned image has been removed (occurs when parent verification expires)
Up 
get /verifications/{id}
Get verification by ID (verificationsIdGet)

Path parameters

id (required)
Path Parameter — default: null

Return type

Verification

Example data

Content-Type: application/json
{
  "documentType" : "US_CA_DL",
  "devices" : [ {
    "displayHeight" : 1080,
    "dateTime" : "3/18/2025 08:25",
    "browserTimeZone" : "America/Los_Angeles",
    "country" : "United States",
    "city" : "Phoenix",
    "origin" : "example.com",
    "isp" : "COMCAST Cable",
    "latitude" : 33.4484,
    "language" : "en-US",
    "operatingSystem" : "Mac OS X 10.15",
    "platform" : "MacIntel",
    "via" : [ "via", "via" ],
    "createdAt" : "2022-01-01T00:00:00Z",
    "browser" : "Firefox 130.0",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "longitude" : -112.0741,
    "offsetMinutes" : -360,
    "browserHeight" : 1080,
    "ipAddressTimeZone" : "America/Los_Angeles",
    "browserDateTime" : "Tue Mar 18 2025 08:25:06 GMT-0600 (Mountain Daylight Time)",
    "ipAddress" : "192.168.1.1",
    "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:130.0) Gecko/20100101 Firefox/130.0",
    "epochMilliseconds" : 1709000000000,
    "displayWidth" : 1920,
    "browserTimeZoneWithOffset" : "America/Denver (-06.00)",
    "region" : "Arizona",
    "asn" : "AS7922",
    "browserWidth" : 1920
  }, {
    "displayHeight" : 1080,
    "dateTime" : "3/18/2025 08:25",
    "browserTimeZone" : "America/Los_Angeles",
    "country" : "United States",
    "city" : "Phoenix",
    "origin" : "example.com",
    "isp" : "COMCAST Cable",
    "latitude" : 33.4484,
    "language" : "en-US",
    "operatingSystem" : "Mac OS X 10.15",
    "platform" : "MacIntel",
    "via" : [ "via", "via" ],
    "createdAt" : "2022-01-01T00:00:00Z",
    "browser" : "Firefox 130.0",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "longitude" : -112.0741,
    "offsetMinutes" : -360,
    "browserHeight" : 1080,
    "ipAddressTimeZone" : "America/Los_Angeles",
    "browserDateTime" : "Tue Mar 18 2025 08:25:06 GMT-0600 (Mountain Daylight Time)",
    "ipAddress" : "192.168.1.1",
    "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:130.0) Gecko/20100101 Firefox/130.0",
    "epochMilliseconds" : 1709000000000,
    "displayWidth" : 1920,
    "browserTimeZoneWithOffset" : "America/Denver (-06.00)",
    "region" : "Arizona",
    "asn" : "AS7922",
    "browserWidth" : 1920
  } ],
  "verifierChecks" : [ {
    "lastName" : "lastName",
    "createdAt" : "2022-01-01T00:00:00Z",
    "mnoFallback" : true,
    "verifier" : "SCAN",
    "verifierResult" : "verifierResult",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "updatedAt" : "2022-01-01T00:00:00Z"
  }, {
    "lastName" : "lastName",
    "createdAt" : "2022-01-01T00:00:00Z",
    "mnoFallback" : true,
    "verifier" : "SCAN",
    "verifierResult" : "verifierResult",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "updatedAt" : "2022-01-01T00:00:00Z"
  } ],
  "scores" : [ {
    "score" : "score",
    "reason" : "reason",
    "createdAt" : "2022-01-01T00:00:00Z",
    "robotRule" : true,
    "verifier" : "DMV",
    "ruleType" : "VERIFIER",
    "rule" : "rule",
    "id" : "d2392d83-8410-41a7-adcf-a792acde7fb9",
    "riskyFields" : [ "riskyFields", "riskyFields" ],
    "updatedAt" : "2022-01-01T00:00:00Z"
  }, {
    "score" : "score",
    "reason" : "reason",
    "createdAt" : "2022-01-01T00:00:00Z",
    "robotRule" : true,
    "verifier" : "DMV",
    "ruleType" : "VERIFIER",
    "rule" : "rule",
    "id" : "d2392d83-8410-41a7-adcf-a792acde7fb9",
    "riskyFields" : [ "riskyFields", "riskyFields" ],
    "updatedAt" : "2022-01-01T00:00:00Z"
  } ],
  "reviewAccessExpiresAt" : "2022-01-01T00:00:00Z",
  "linkUrlExpiresAt" : "2022-01-01T00:00:00Z",
  "expiredLinkUrlAccess" : true,
  "createdAt" : "2022-01-01T00:00:00Z",
  "supportedVerifiers" : [ "DMV", "DMV" ],
  "overallRisk" : "false",
  "requestedMessages" : [ {
    "phoneNumber" : "+12003004000",
    "channel" : "SMS"
  }, {
    "phoneNumber" : "+12003004000",
    "channel" : "SMS"
  } ],
  "portalUrl" : "https://portal.example.net/tenants/1C91D8B3-0F1F-40B7-BDB8-2E0B5395DE32/verifications/1C91D8B3-0F1F-40B7-BDB8-2E0B5395DE12",
  "linkUrl" : "https://atop.example.net/identity/verifications/1C91D8B3-0F1F-40B7-BDB8-2E0B5395DE12",
  "messages" : [ {
    "createdAt" : "2022-01-01T00:00:00Z",
    "phoneNumber" : "+12003004000",
    "channel" : "SMS",
    "id" : "id",
    "status" : "status",
    "updatedAt" : "2022-01-01T00:00:00Z"
  }, {
    "createdAt" : "2022-01-01T00:00:00Z",
    "phoneNumber" : "+12003004000",
    "channel" : "SMS",
    "id" : "id",
    "status" : "status",
    "updatedAt" : "2022-01-01T00:00:00Z"
  } ],
  "callbackUrl" : "https://example.com/callback/unique/to/this/request/8b62142a99ba759d8c9153b68765513c62180891",
  "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "expiredReviewAccess" : true,
  "agentEmailAddress" : "agent@example.com",
  "status" : "WAITING",
  "updatedAt" : "2022-01-01T00:00:00Z"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Verification details Verification

404

Verification not found
Up 
get /verifications/{id}/masked_document
Get the verification's document with PII partially masked (verificationsIdMaskedDocumentGet)

Path parameters

id (required)
Path Parameter — default: null

Return type

_verifications__id__document_get_200_response

Example data

Content-Type: application/json
{
  "document" : {
    "lastName" : "lastName",
    "zipCode" : "zipCode",
    "documentType" : "documentType",
    "city" : "city",
    "documentNumber" : "documentNumber",
    "zip4" : "zip4",
    "documentNumberSuffix" : "documentNumberSuffix",
    "expiryDate" : "expiryDate",
    "createdAt" : "2022-01-01T00:00:00Z",
    "middleInitial" : "middleInitial",
    "eyeColor" : "eyeColor",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "state" : "state",
    "issueDate" : "issueDate",
    "height" : "height",
    "updatedAt" : "2022-01-01T00:00:00Z",
    "placeOfBirth" : "placeOfBirth",
    "address2" : "address2",
    "address1" : "address1",
    "sex" : "sex",
    "weight" : "weight",
    "dateOfBirth" : "dateOfBirth",
    "firstName" : "firstName",
    "issuingAuthority" : "issuingAuthority",
    "nationality" : "nationality",
    "middleName" : "middleName",
    "age" : "age"
  }
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

The verification's partially masked document _verifications__id__document_get_200_response

404

Verification was not found or document is not yet available

410

Document has been removed (occurs when parent verification expires)
Up 
get /verifications/{id}/messages
Get all messages for a verification (verificationsIdMessagesGet)

Path parameters

id (required)
Path Parameter — default: null

Return type

array[_verifications__id__messages_get_200_response_inner]

Example data

Content-Type: application/json
[ {
  "createdAt" : "2022-01-01T00:00:00Z",
  "phoneNumber" : "+12003004000",
  "channel" : "SMS",
  "id" : "id",
  "status" : "status",
  "updatedAt" : "2022-01-01T00:00:00Z"
}, {
  "createdAt" : "2022-01-01T00:00:00Z",
  "phoneNumber" : "+12003004000",
  "channel" : "SMS",
  "id" : "id",
  "status" : "status",
  "updatedAt" : "2022-01-01T00:00:00Z"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

List of messages

404

Messages not found
Up 
get /verifications/{id}/messages/{messageId}
Get a verification's message by ID (verificationsIdMessagesMessageIdGet)

Path parameters

id (required)
Path Parameter — default: null
messageId (required)
Path Parameter — default: null

Return type

_verifications__id__messages_get_200_response_inner

Example data

Content-Type: application/json
{
  "createdAt" : "2022-01-01T00:00:00Z",
  "phoneNumber" : "+12003004000",
  "channel" : "SMS",
  "id" : "id",
  "status" : "status",
  "updatedAt" : "2022-01-01T00:00:00Z"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Message details _verifications__id__messages_get_200_response_inner

404

Verification or message were not found
Up 
post /verifications/{id}/messages
Add a message to a verification (verificationsIdMessagesPost)

Path parameters

id (required)
Path Parameter — default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_verifications__id__messages_get_200_response_inner _verifications__id__messages_get_200_response_inner (required)
Body Parameter —

Example data

Content-Type: application/json
{
  "error" : "error"
}

Example data

Content-Type: application/json
{
  "error" : "error"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

201

Message added successfully

400

Bad request

404

Not found

410

Messages can no longer be added to this verification

422

Sim swap was detected for a TRUSTED_SMS ErrorResponse

429

Quota limit has been reached ErrorResponse
Up 
get /verifications/{id}/risk_scores
Get all scores for a verification (verificationsIdRiskScoresGet)

Path parameters

id (required)
Path Parameter — default: null

Return type

array[RiskScore]

Example data

Content-Type: application/json
[ {
  "score" : "score",
  "reason" : "reason",
  "createdAt" : "2022-01-01T00:00:00Z",
  "robotRule" : true,
  "verifier" : "DMV",
  "ruleType" : "VERIFIER",
  "rule" : "rule",
  "id" : "d2392d83-8410-41a7-adcf-a792acde7fb9",
  "riskyFields" : [ "riskyFields", "riskyFields" ],
  "updatedAt" : "2022-01-01T00:00:00Z"
}, {
  "score" : "score",
  "reason" : "reason",
  "createdAt" : "2022-01-01T00:00:00Z",
  "robotRule" : true,
  "verifier" : "DMV",
  "ruleType" : "VERIFIER",
  "rule" : "rule",
  "id" : "d2392d83-8410-41a7-adcf-a792acde7fb9",
  "riskyFields" : [ "riskyFields", "riskyFields" ],
  "updatedAt" : "2022-01-01T00:00:00Z"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

List of risk scores

404

Verification not found
Up 
get /verifications/{id}/verifier_checks
Get all verifier_checks for a verification (verificationsIdVerifierChecksGet)

Path parameters

id (required)
Path Parameter — default: null

Return type

array[_verifications__id__verifier_checks_get_200_response_inner]

Example data

Content-Type: application/json
[ {
  "lastName" : "lastName",
  "createdAt" : "2022-01-01T00:00:00Z",
  "mnoFallback" : true,
  "verifier" : "SCAN",
  "verifierResult" : "verifierResult",
  "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "updatedAt" : "2022-01-01T00:00:00Z"
}, {
  "lastName" : "lastName",
  "createdAt" : "2022-01-01T00:00:00Z",
  "mnoFallback" : true,
  "verifier" : "SCAN",
  "verifierResult" : "verifierResult",
  "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "updatedAt" : "2022-01-01T00:00:00Z"
} ]

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

List of verifier checks

404

Not found
Up 
post /verifications/{id}/verifier_checks
Add a verifier_checker to a verification (verificationsIdVerifierChecksPost)

Path parameters

id (required)
Path Parameter — default: null

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

_verifications__id__verifier_checks_post_request _verifications__id__verifier_checks_post_request (required)
Body Parameter —

Responses

202

Accepted - check will be run when a document is available

400

Bad request

410

Verification check can no longer be added to this verification
Up 
get /verifications/{id}/verifier_checks/{verifierCheckId}
Get a specific verifier checker by ID (verificationsIdVerifierChecksVerifierCheckIdGet)

Path parameters

id (required)
Path Parameter — default: null
verifierCheckId (required)
Path Parameter — default: null

Return type

_verifications__id__verifier_checks_post_request

Example data

Content-Type: application/json
{
  "lastName" : "lastName",
  "createdAt" : "2022-01-01T00:00:00Z",
  "mnoFallback" : true,
  "documentType" : "documentType",
  "verifier" : "DMV",
  "verifierResult" : "SUCCESS",
  "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "matches" : {
    "lastName" : true,
    "zipCode" : true,
    "documentType" : true,
    "address2" : true,
    "city" : true,
    "documentNumber" : true,
    "address1" : true,
    "sex" : true,
    "weight" : true,
    "zip4" : true,
    "dateOfBirth" : true,
    "expiryDate" : true,
    "firstName" : true,
    "middleInitial" : true,
    "eyeColor" : true,
    "middleName" : true,
    "state" : true,
    "issueDate" : true,
    "height" : true
  },
  "documentNumberSuffix" : "documentNumberSuffix",
  "updatedAt" : "2022-01-01T00:00:00Z"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Verifier checks details _verifications__id__verifier_checks_post_request

404

Verification or verifier check not found
Up 
post /verifications
Create a new verification (verificationsPost)

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

VerificationRequest VerificationRequest (required)
Body Parameter —

Return type

Verification

Example data

Content-Type: application/json
{
  "documentType" : "US_CA_DL",
  "devices" : [ {
    "displayHeight" : 1080,
    "dateTime" : "3/18/2025 08:25",
    "browserTimeZone" : "America/Los_Angeles",
    "country" : "United States",
    "city" : "Phoenix",
    "origin" : "example.com",
    "isp" : "COMCAST Cable",
    "latitude" : 33.4484,
    "language" : "en-US",
    "operatingSystem" : "Mac OS X 10.15",
    "platform" : "MacIntel",
    "via" : [ "via", "via" ],
    "createdAt" : "2022-01-01T00:00:00Z",
    "browser" : "Firefox 130.0",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "longitude" : -112.0741,
    "offsetMinutes" : -360,
    "browserHeight" : 1080,
    "ipAddressTimeZone" : "America/Los_Angeles",
    "browserDateTime" : "Tue Mar 18 2025 08:25:06 GMT-0600 (Mountain Daylight Time)",
    "ipAddress" : "192.168.1.1",
    "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:130.0) Gecko/20100101 Firefox/130.0",
    "epochMilliseconds" : 1709000000000,
    "displayWidth" : 1920,
    "browserTimeZoneWithOffset" : "America/Denver (-06.00)",
    "region" : "Arizona",
    "asn" : "AS7922",
    "browserWidth" : 1920
  }, {
    "displayHeight" : 1080,
    "dateTime" : "3/18/2025 08:25",
    "browserTimeZone" : "America/Los_Angeles",
    "country" : "United States",
    "city" : "Phoenix",
    "origin" : "example.com",
    "isp" : "COMCAST Cable",
    "latitude" : 33.4484,
    "language" : "en-US",
    "operatingSystem" : "Mac OS X 10.15",
    "platform" : "MacIntel",
    "via" : [ "via", "via" ],
    "createdAt" : "2022-01-01T00:00:00Z",
    "browser" : "Firefox 130.0",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "longitude" : -112.0741,
    "offsetMinutes" : -360,
    "browserHeight" : 1080,
    "ipAddressTimeZone" : "America/Los_Angeles",
    "browserDateTime" : "Tue Mar 18 2025 08:25:06 GMT-0600 (Mountain Daylight Time)",
    "ipAddress" : "192.168.1.1",
    "userAgent" : "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:130.0) Gecko/20100101 Firefox/130.0",
    "epochMilliseconds" : 1709000000000,
    "displayWidth" : 1920,
    "browserTimeZoneWithOffset" : "America/Denver (-06.00)",
    "region" : "Arizona",
    "asn" : "AS7922",
    "browserWidth" : 1920
  } ],
  "verifierChecks" : [ {
    "lastName" : "lastName",
    "createdAt" : "2022-01-01T00:00:00Z",
    "mnoFallback" : true,
    "verifier" : "SCAN",
    "verifierResult" : "verifierResult",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "updatedAt" : "2022-01-01T00:00:00Z"
  }, {
    "lastName" : "lastName",
    "createdAt" : "2022-01-01T00:00:00Z",
    "mnoFallback" : true,
    "verifier" : "SCAN",
    "verifierResult" : "verifierResult",
    "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "updatedAt" : "2022-01-01T00:00:00Z"
  } ],
  "scores" : [ {
    "score" : "score",
    "reason" : "reason",
    "createdAt" : "2022-01-01T00:00:00Z",
    "robotRule" : true,
    "verifier" : "DMV",
    "ruleType" : "VERIFIER",
    "rule" : "rule",
    "id" : "d2392d83-8410-41a7-adcf-a792acde7fb9",
    "riskyFields" : [ "riskyFields", "riskyFields" ],
    "updatedAt" : "2022-01-01T00:00:00Z"
  }, {
    "score" : "score",
    "reason" : "reason",
    "createdAt" : "2022-01-01T00:00:00Z",
    "robotRule" : true,
    "verifier" : "DMV",
    "ruleType" : "VERIFIER",
    "rule" : "rule",
    "id" : "d2392d83-8410-41a7-adcf-a792acde7fb9",
    "riskyFields" : [ "riskyFields", "riskyFields" ],
    "updatedAt" : "2022-01-01T00:00:00Z"
  } ],
  "reviewAccessExpiresAt" : "2022-01-01T00:00:00Z",
  "linkUrlExpiresAt" : "2022-01-01T00:00:00Z",
  "expiredLinkUrlAccess" : true,
  "createdAt" : "2022-01-01T00:00:00Z",
  "supportedVerifiers" : [ "DMV", "DMV" ],
  "overallRisk" : "false",
  "requestedMessages" : [ {
    "phoneNumber" : "+12003004000",
    "channel" : "SMS"
  }, {
    "phoneNumber" : "+12003004000",
    "channel" : "SMS"
  } ],
  "portalUrl" : "https://portal.example.net/tenants/1C91D8B3-0F1F-40B7-BDB8-2E0B5395DE32/verifications/1C91D8B3-0F1F-40B7-BDB8-2E0B5395DE12",
  "linkUrl" : "https://atop.example.net/identity/verifications/1C91D8B3-0F1F-40B7-BDB8-2E0B5395DE12",
  "messages" : [ {
    "createdAt" : "2022-01-01T00:00:00Z",
    "phoneNumber" : "+12003004000",
    "channel" : "SMS",
    "id" : "id",
    "status" : "status",
    "updatedAt" : "2022-01-01T00:00:00Z"
  }, {
    "createdAt" : "2022-01-01T00:00:00Z",
    "phoneNumber" : "+12003004000",
    "channel" : "SMS",
    "id" : "id",
    "status" : "status",
    "updatedAt" : "2022-01-01T00:00:00Z"
  } ],
  "callbackUrl" : "https://example.com/callback/unique/to/this/request/8b62142a99ba759d8c9153b68765513c62180891",
  "id" : "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "expiredReviewAccess" : true,
  "agentEmailAddress" : "agent@example.com",
  "status" : "WAITING",
  "updatedAt" : "2022-01-01T00:00:00Z"
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

201

Verification created successfully Verification

400

Bad request

Models

[ Jump to Methods ]

Table of Contents

  1. Device -
  2. DmvVerifierCheck -
  3. DmvVerifierCheck_matches -
  4. Document -
  5. EmailMessage -
  6. ErrorResponse -
  7. MnoVerifierCheck -
  8. MnoVerifierCheck_matches -
  9. RequestedEmailMessage -
  10. RequestedSmsMessage -
  11. RequestedTrustedSmsMessage -
  12. RiskScore -
  13. ScanVerifierCheck -
  14. ScannedImage -
  15. SmsMessage -
  16. TrustedSmsMessage -
  17. Verification -
  18. VerificationRequest -
  19. VerificationRequest_requestedMessages_inner -
  20. Verification_messages_inner -
  21. Verification_supportedVerifiers_inner -
  22. Verifier -
  23. _verifications__id__document_get_200_response -
  24. _verifications__id__messages_get_200_response_inner -
  25. _verifications__id__verifier_checks_get_200_response_inner -
  26. _verifications__id__verifier_checks_post_request -

Device - Up

id (optional)
UUID format: uuid
platform (optional)
String Required field
language (optional)
String Required field
browserTimeZone (optional)
String Required field. IANA timezone ID (e.g., America/New_York, Europe/London)
origin (optional)
String Required field
browserDateTime (optional)
String Required field. Browser's local datetime in format 'EEE MMM dd yyyy HH:mm:ss GMTZ (zzzz)'
userAgent (optional)
String
operatingSystem (optional)
String
browser (optional)
String
displayWidth (optional)
Integer
displayHeight (optional)
Integer
browserHeight (optional)
Integer
browserWidth (optional)
Integer
ipAddress (optional)
String format: ipv4
ipAddressTimeZone (optional)
String IANA timezone ID derived from IP address
country (optional)
String
region (optional)
String
city (optional)
String
isp (optional)
String
latitude (optional)
Float format: float
longitude (optional)
Float format: float
via (optional)
array[String]
offsetMinutes (optional)
Integer Required field. Timezone offset in minutes
epochMilliseconds (optional)
Integer Required field. Unix timestamp in milliseconds
asn (optional)
String
dateTime (optional)
String Formatted datetime in local timezone
browserTimeZoneWithOffset (optional)
String Timezone with offset in format 'Region/City (GMT±HH.MM)'
createdAt (optional)
Date format: date-time

DmvVerifierCheck - Up

id (optional)
UUID format: uuid
lastName (optional)
String
documentType (optional)
String
documentNumberSuffix (optional)
String
verifier
String
Enum:
DMV
verifierResult (optional)
String
Enum:
SUCCESS
FAILURE
FATAL
mnoFallback (optional)
Boolean
matches (optional)
DmvVerifierCheck_matches
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time

DmvVerifierCheck_matches - Up

documentNumber (optional)
Boolean
documentType (optional)
Boolean
issueDate (optional)
Boolean
expiryDate (optional)
Boolean
firstName (optional)
Boolean
middleName (optional)
Boolean
middleInitial (optional)
Boolean
lastName (optional)
Boolean
address1 (optional)
Boolean
address2 (optional)
Boolean
city (optional)
Boolean
state (optional)
Boolean
zipCode (optional)
Boolean
zip4 (optional)
Boolean
dateOfBirth (optional)
Boolean
eyeColor (optional)
Boolean
sex (optional)
Boolean
height (optional)
Boolean
weight (optional)
Boolean

Document - Up

id (optional)
UUID format: uuid
documentType (optional)
String
documentNumber (optional)
String
documentNumberSuffix (optional)
String
issueDate (optional)
String
expiryDate (optional)
String
firstName (optional)
String
middleName (optional)
String
middleInitial (optional)
String
lastName (optional)
String
address1 (optional)
String
address2 (optional)
String
city (optional)
String
state (optional)
String
zipCode (optional)
String
zip4 (optional)
String
dateOfBirth (optional)
String
eyeColor (optional)
String
sex (optional)
String
height (optional)
String
weight (optional)
String
age (optional)
String
nationality (optional)
String
issuingAuthority (optional)
String
placeOfBirth (optional)
String
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time

EmailMessage - Up

id (optional)
String
emailAddress
String format: email
channel
String
Enum:
EMAIL
status (optional)
String
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time

ErrorResponse - Up

error (optional)
String

MnoVerifierCheck - Up

id (optional)
UUID format: uuid
phoneNumber
String
lastName (optional)
String
verifier
String
Enum:
MNO_V
verifierResult (optional)
String
mnoFallback (optional)
Boolean
matches (optional)
MnoVerifierCheck_matches
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time

MnoVerifierCheck_matches - Up

firstName (optional)
Boolean
middleName (optional)
Boolean
middleInitial (optional)
Boolean
lastName (optional)
Boolean
address1 (optional)
Boolean
address2 (optional)
Boolean
city (optional)
Boolean
state (optional)
Boolean
zipCode (optional)
Boolean
zip4 (optional)
Boolean
dateOfBirth (optional)
Boolean
phoneNumber (optional)
Boolean
phoneSim (optional)
Boolean

RequestedEmailMessage - Up

emailAddress
String format: email
channel
String
Enum:
EMAIL

RequestedSmsMessage - Up

phoneNumber
String
channel
String
Enum:
SMS

RequestedTrustedSmsMessage - Up

phoneNumber
String
channel
String
Enum:
TRUSTED_SMS

RiskScore - Up

id (optional)
UUID format: uuid
score (optional)
String
rule (optional)
String
reason (optional)
String
ruleType (optional)
String
Enum:
VERIFIER
DEVICE
SCAN
riskyFields (optional)
array[String]
verifier (optional)
String
Enum:
DMV
MNO_V
robotRule (optional)
Boolean
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time

ScanVerifierCheck - Up

id (optional)
UUID format: uuid
lastName (optional)
String
verifier (optional)
String
Enum:
SCAN
verifierResult (optional)
String
mnoFallback (optional)
Boolean
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time

ScannedImage - Up

data (optional)
File format: binary

SmsMessage - Up

id (optional)
String
phoneNumber
String
channel
String
Enum:
SMS
status (optional)
String
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time

TrustedSmsMessage - Up

id (optional)
String
phoneNumber
String
channel
String
Enum:
TRUSTED_SMS
status (optional)
String
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time

Verification - Up

id (optional)
UUID format: uuid
agentEmailAddress (optional)
String format: email
documentType (optional)
String
Enum:
US_CA_DL
UK_DL
PASSPORT
linkUrl (optional)
URI format: uri
callbackUrl (optional)
URI format: uri
linkUrlExpiresAt (optional)
Date format: date-time
reviewAccessExpiresAt (optional)
Date format: date-time
portalUrl (optional)
URI format: uri
expiredLinkUrlAccess (optional)
Boolean
expiredReviewAccess (optional)
Boolean
overallRisk (optional)
String
Enum:
false
LOW
MEDIUM
HIGH
supportedVerifiers (optional)
array[Verification_supportedVerifiers_inner]
status (optional)
String
Enum:
WAITING
SCANNED
EXPIRED
requestedMessages (optional)
array[VerificationRequest_requestedMessages_inner]
devices (optional)
array[Device]
verifierChecks (optional)
array[_verifications__id__verifier_checks_get_200_response_inner]
scores (optional)
array[RiskScore]
messages (optional)
array[Verification_messages_inner]
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time

VerificationRequest - Up

agentEmailAddress
String format: email
documentType
String
Enum:
US_CA_DL
UK_DL
PASSPORT
callbackUrl (optional)
URI format: uri
requestedMessages (optional)
array[VerificationRequest_requestedMessages_inner]

VerificationRequest_requestedMessages_inner - Up

phoneNumber
String
channel
String
Enum:
EMAIL
emailAddress
String format: email

Verification_messages_inner - Up

id (optional)
String
phoneNumber
String
channel
String
Enum:
EMAIL
status (optional)
String
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time
emailAddress
String format: email

Verification_supportedVerifiers_inner - Up

Verifier - Up

_verifications__id__document_get_200_response - Up

document (optional)
Document

_verifications__id__messages_get_200_response_inner - Up

id (optional)
String
phoneNumber
String
channel
String
Enum:
EMAIL
status (optional)
String
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time
emailAddress
String format: email

_verifications__id__verifier_checks_get_200_response_inner - Up

id (optional)
UUID format: uuid
lastName (optional)
String
verifier
String
Enum:
MNO_V
verifierResult (optional)
String
mnoFallback (optional)
Boolean
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time
documentType (optional)
String
documentNumberSuffix (optional)
String
matches (optional)
MnoVerifierCheck_matches
phoneNumber
String

_verifications__id__verifier_checks_post_request - Up

id (optional)
UUID format: uuid
lastName (optional)
String
documentType (optional)
String
documentNumberSuffix (optional)
String
verifier
String
Enum:
MNO_V
verifierResult (optional)
String
mnoFallback (optional)
Boolean
matches (optional)
MnoVerifierCheck_matches
createdAt (optional)
Date format: date-time
updatedAt (optional)
Date format: date-time
phoneNumber
String