API docs by Redocly

Verification API (2.2.0)

Download OpenAPI specification:

API Support: support@trusona.com URL: https://trusona.com

Base URL: https://authcloud.trusona.net

API to manage verifications, messages, checkers, devices, and risk scores.

Verifications

Get verifications since a specific time or verification ID

Retrieve a collection of verifications that have been created or updated since the specified time or verification ID.

The since parameter can be either:

  • A UUID of a verification (returns verifications created after that verification)
  • An ISO 8601 date-time string (e.g., "2022-01-01T00:00:00Z")
  • A date string in YYYY-MM-DD format
Authorizations:
bearerAuth
query Parameters
since
required
string non-empty
until
string
count
integer <int32>
Default: 1000
page
integer <int32>
Default: 0

Responses

Response samples

Content type
*/*
[
  {
    "id": "bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "agentEmailAddress": "agent@example.com",
    "documentType": "US_CA_DL",
    "linkUrl": "https://verify.example.com/identity/verifications/BD30618F-06D3-45C5-AE52-C36751FC20B2",
    "linkUrlExpiresAt": "2026-05-05T18:15:00Z",
    "reviewAccessExpiresAt": "2026-05-05T18:30:00Z",
    "createdAt": "2026-05-05T18:00:00Z",
    "updatedAt": "2026-05-05T18:01:05Z",
    "status": "SCANNED",
    "closed": true,
    "expiredReviewAccess": true,
    "expiredLinkUrlAccess": true,
    "overallRisk": "LOW",
    "workspaceLink": "https://portal.example.com/tenant-id/verifications/bd30618f-06d3-45c5-ae52-c36751fc20b2",
    "supportedVerifiers": [],
    "attachments": [
      {
        "attachmentType": "WORKSPACE_CALLBACKS",
        "urls": []
      }
    ],
    "verifierChecks": [
      {
        "id": "7c19e69d-e4b9-4931-87a4-3a277af6fe72",
        "lastName": "SMITH",
        "phoneNumber": "+12025551234",
        "documentType": "US_CA_DL",
        "documentNumberSuffix": "5678",
        "createdAt": "2026-05-05T18:01:06Z",
        "verifier": "MNO_V",
        "verifierResult": "SUCCESS",
        "phoneNumberSuffix": "1234",
        "phoneNumberCountryCode": "1",
        "matches": {
          "lastName": true,
          "firstName": true,
          "dateOfBirth": true,
          "phoneNumber": true,
          "address1": true,
          "address2": null,
          "city": true,
          "state": true,
          "zipCode": true,
          "country": true,
          "phoneSim": null
        },
        "externalId": "A1.bCDE"
      },
      {
        "id": "960b7d8a-1c10-4f9d-a2e0-67c68fe688e7",
        "lastName": "SMITH",
        "documentType": "US_CA_DL",
        "documentNumberSuffix": "5678",
        "createdAt": "2026-05-05T18:01:09Z",
        "verifier": "DMV",
        "verifierResult": "SUCCESS",
        "matches": {
          "lastName": true,
          "firstName": true,
          "middleName": true,
          "middleInitial": true,
          "dateOfBirth": true,
          "documentNumber": true,
          "issueDate": true,
          "expiryDate": true,
          "eyeColor": true,
          "sex": true,
          "address1": true,
          "address2": null,
          "city": true,
          "state": true,
          "zipCode": true,
          "height": true,
          "zip4": null,
          "weight": true,
          "documentType": true
        }
      }
    ],
    "messages": [
      {
        "id": "f2aafebd-8d41-4366-9ead-59e04931c3a8",
        "status": "DELIVERED",
        "createdAt": "2026-05-05T18:00:00Z",
        "channel": "SMS",
        "recipient": "+12025551234",
        "simSwapped": false
      }
    ],
    "devices": [
      {
        "id": "fb125038-2656-4b51-85ad-6a495876f107",
        "platform": "iPhone",
        "language": "en-US",
        "browserTimeZone": "America/Los_Angeles",
        "origin": null,
        "browserDateTime": "Tue May 05 2026 11:00:00 GMT-0700 (Pacific Daylight Time)",
        "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
        "operatingSystem": "iOS 18.5",
        "browser": "Mobile Safari 18.5",
        "displayWidth": 390,
        "displayHeight": 844,
        "browserHeight": 844,
        "browserWidth": 390,
        "ipAddress": "192.0.2.1",
        "ipAddressTimeZone": "America/Los_Angeles",
        "country": "United States",
        "region": "California",
        "city": "San Francisco",
        "isp": "Example ISP, Inc.",
        "createdAt": "2026-05-05T18:00:30Z",
        "latitude": 37.7749,
        "longitude": -122.4194,
        "gpsLatitude": null,
        "gpsLongitude": null,
        "via": [],
        "offsetMinutes": 420,
        "epochMilliseconds": 1778000000000,
        "asn": null,
        "dateTime": "5/5/2026 09:53",
        "browserTimeZoneWithOffset": "America/Los Angeles (-7)",
        "scanCode": "123",
        "linkCode": "1920",
        "scannedDocument": true,
        "blacklistedNetwork": false,
        "whitelistedNetwork": false,
        "truPassUsed": false,
        "fingerprint": "abc123def456ghi789jkl012mno345pqr678stu9",
        "turnstileRobot": null,
        "turnstileError": null
      }
    ],
    "riskScores": [
      {
        "ruleType": "DEVICE",
        "id": "0d98bd5f-7e8d-4430-a048-14775c6e57f9",
        "score": "NO",
        "rule": "DEV4D",
        "reason": "VPN/Proxy - using iCloud Private Relay",
        "type": "DEVICE",
        "riskyFields": [
          "ipAddress"
        ],
        "riskyDevices": [
          "fb125038-2656-4b51-85ad-6a495876f107"
        ],
        "robotRule": true,
        "createdAt": "2026-05-05T18:00:31Z"
      },
      {
        "ruleType": "VERIFIER",
        "id": "ad37692c-0e7b-4eeb-a191-f5ce9cd2bb45",
        "score": "LOW",
        "rule": "VER5A",
        "reason": "Between 1% and 20% of DMV data is incorrect",
        "type": "VERIFIER",
        "riskyFields": [
          "issueDate",
          "expiryDate"
        ],
        "verifier": "DMV",
        "riskyDevices": [],
        "robotRule": false,
        "createdAt": "2026-05-05T18:01:09Z"
      }
    ],
    "billable": true,
    "billableAt": "2026-05-05T18:00:31Z"
  }
]

Create a new verification

Authorizations:
bearerAuth
Request Body schema: application/json
required
documentType
required
string
Enum: "US_CA_DL" "UK_DL" "PASSPORT" "INDIA_DL" "INDIA_ID" "INDIA_PAN" "PHILIPPINES_DL" "PHILIPPINES_ID" "PHILIPPINES_MULTI_ID" "US_MILITARY_ID" "US_VETERAN_ID" "SINGAPORE_DL" "SINGAPORE_ID" "SINGAPORE_WORK_PERMIT" "SINGAPORE_EMPLOYMENT_PASS" "PAKISTAN_ID" "AUSTRALIA_DL" "MEXICO_DL" "NETHERLANDS_DL"
callbackUrl
string <uri>
Array of RequestedVerifier (object) or RequestedDmvVerifier (object) or RequestedLexisNexisVerifier (object) or RequestedMnoVerifier (object) unique

Set of verifiers to run against this verification. Each entry uses the 'verifier' discriminator field.

object (VerificationSubject)

Optional identity information about the subject of this verification, used by the ExpectedSubjectVerifier to compare against the scanned document.

Array of RequestedMessage (object) or RequestedCopyMessage (object) or RequestedEmailMessage (object) or RequestedSmsMessage (object) or RequestedTrustedSmsMessage (object) [ 0 .. 2 ] items unique

Set of messages to send for this verification. Each entry uses the 'channel' discriminator field. Maximum 2.

status
string
Value: "CREATED"

Responses

Request samples

Content type
application/json
{
  • "documentType": "US_CA_DL",
  • "callbackUrl": "https://example.com/callback/unique/to/this/request/8b62142a99ba759d8c9153b68765513c62180891",
  • "requestedVerifiers": [
    ],
  • "subject": {
    },
  • "requestedMessages": [
    ],
  • "status": "CREATED"
}

Response samples

Content type
*/*
{
  "id": "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "agentEmailAddress": "agent@example.com",
  "documentType": "US_CA_DL",
  "linkUrl": "https://verify.example.com/identity/verifications/BD30618F-06D3-45C5-AE52-C36751FC20B2",
  "linkUrlExpiresAt": "2026-05-05T18:15:00Z",
  "reviewAccessExpiresAt": "2026-05-05T18:30:00Z",
  "createdAt": "2026-05-05T18:00:00Z",
  "updatedAt": "2026-05-05T18:01:05Z",
  "status": "SCANNED",
  "closed": true,
  "expiredReviewAccess": true,
  "expiredLinkUrlAccess": true,
  "overallRisk": "LOW",
  "workspaceLink": "https://portal.example.com/tenant-id/verifications/bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "supportedVerifiers": [],
  "attachments": [
    {
      "attachmentType": "WORKSPACE_CALLBACKS",
      "urls": []
    }
  ],
  "verifierChecks": [
    {
      "id": "7c19e69d-e4b9-4931-87a4-3a277af6fe72",
      "lastName": "SMITH",
      "phoneNumber": "+12025551234",
      "documentType": "US_CA_DL",
      "documentNumberSuffix": "5678",
      "createdAt": "2026-05-05T18:01:06Z",
      "verifier": "MNO_V",
      "verifierResult": "SUCCESS",
      "phoneNumberSuffix": "1234",
      "phoneNumberCountryCode": "1",
      "matches": {
        "lastName": true,
        "firstName": true,
        "dateOfBirth": true,
        "phoneNumber": true,
        "address1": true,
        "address2": null,
        "city": true,
        "state": true,
        "zipCode": true,
        "country": true,
        "phoneSim": null
      },
      "externalId": "A1.bCDE"
    },
    {
      "id": "960b7d8a-1c10-4f9d-a2e0-67c68fe688e7",
      "lastName": "SMITH",
      "documentType": "US_CA_DL",
      "documentNumberSuffix": "5678",
      "createdAt": "2026-05-05T18:01:09Z",
      "verifier": "DMV",
      "verifierResult": "SUCCESS",
      "matches": {
        "lastName": true,
        "firstName": true,
        "middleName": true,
        "middleInitial": true,
        "dateOfBirth": true,
        "documentNumber": true,
        "issueDate": true,
        "expiryDate": true,
        "eyeColor": true,
        "sex": true,
        "address1": true,
        "address2": null,
        "city": true,
        "state": true,
        "zipCode": true,
        "height": true,
        "zip4": null,
        "weight": true,
        "documentType": true
      }
    }
  ],
  "messages": [
    {
      "id": "f2aafebd-8d41-4366-9ead-59e04931c3a8",
      "status": "DELIVERED",
      "createdAt": "2026-05-05T18:00:00Z",
      "channel": "SMS",
      "recipient": "+12025551234",
      "simSwapped": false
    }
  ],
  "devices": [
    {
      "id": "fb125038-2656-4b51-85ad-6a495876f107",
      "platform": "iPhone",
      "language": "en-US",
      "browserTimeZone": "America/Los_Angeles",
      "origin": null,
      "browserDateTime": "Tue May 05 2026 11:00:00 GMT-0700 (Pacific Daylight Time)",
      "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
      "operatingSystem": "iOS 18.5",
      "browser": "Mobile Safari 18.5",
      "displayWidth": 390,
      "displayHeight": 844,
      "browserHeight": 844,
      "browserWidth": 390,
      "ipAddress": "192.0.2.1",
      "ipAddressTimeZone": "America/Los_Angeles",
      "country": "United States",
      "region": "California",
      "city": "San Francisco",
      "isp": "Example ISP, Inc.",
      "createdAt": "2026-05-05T18:00:30Z",
      "latitude": 37.7749,
      "longitude": -122.4194,
      "gpsLatitude": null,
      "gpsLongitude": null,
      "via": [],
      "offsetMinutes": 420,
      "epochMilliseconds": 1778000000000,
      "asn": null,
      "dateTime": "5/5/2026 09:53",
      "browserTimeZoneWithOffset": "America/Los Angeles (-7)",
      "scanCode": "123",
      "linkCode": "1920",
      "scannedDocument": true,
      "blacklistedNetwork": false,
      "whitelistedNetwork": false,
      "truPassUsed": false,
      "fingerprint": "abc123def456ghi789jkl012mno345pqr678stu9",
      "turnstileRobot": null,
      "turnstileError": null
    }
  ],
  "riskScores": [
    {
      "ruleType": "DEVICE",
      "id": "0d98bd5f-7e8d-4430-a048-14775c6e57f9",
      "score": "NO",
      "rule": "DEV4D",
      "reason": "VPN/Proxy - using iCloud Private Relay",
      "type": "DEVICE",
      "riskyFields": [
        "ipAddress"
      ],
      "riskyDevices": [
        "fb125038-2656-4b51-85ad-6a495876f107"
      ],
      "robotRule": true,
      "createdAt": "2026-05-05T18:00:31Z"
    },
    {
      "ruleType": "VERIFIER",
      "id": "ad37692c-0e7b-4eeb-a191-f5ce9cd2bb45",
      "score": "LOW",
      "rule": "VER5A",
      "reason": "Between 1% and 20% of DMV data is incorrect",
      "type": "VERIFIER",
      "riskyFields": [
        "issueDate",
        "expiryDate"
      ],
      "verifier": "DMV",
      "riskyDevices": [],
      "robotRule": false,
      "createdAt": "2026-05-05T18:01:09Z"
    }
  ],
  "billable": true,
  "billableAt": "2026-05-05T18:00:31Z"
}

Get verification by ID

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>

Responses

Response samples

Content type
*/*
{
  "id": "bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "agentEmailAddress": "agent@example.com",
  "documentType": "US_CA_DL",
  "linkUrl": "https://verify.example.com/identity/verifications/BD30618F-06D3-45C5-AE52-C36751FC20B2",
  "linkUrlExpiresAt": "2026-05-05T18:15:00Z",
  "reviewAccessExpiresAt": "2026-05-05T18:30:00Z",
  "createdAt": "2026-05-05T18:00:00Z",
  "updatedAt": "2026-05-05T18:01:05Z",
  "status": "SCANNED",
  "closed": true,
  "expiredReviewAccess": true,
  "expiredLinkUrlAccess": true,
  "overallRisk": "LOW",
  "workspaceLink": "https://portal.example.com/tenant-id/verifications/bd30618f-06d3-45c5-ae52-c36751fc20b2",
  "supportedVerifiers": [],
  "attachments": [
    {
      "attachmentType": "WORKSPACE_CALLBACKS",
      "urls": []
    }
  ],
  "verifierChecks": [
    {
      "id": "7c19e69d-e4b9-4931-87a4-3a277af6fe72",
      "lastName": "SMITH",
      "phoneNumber": "+12025551234",
      "documentType": "US_CA_DL",
      "documentNumberSuffix": "5678",
      "createdAt": "2026-05-05T18:01:06Z",
      "verifier": "MNO_V",
      "verifierResult": "SUCCESS",
      "phoneNumberSuffix": "1234",
      "phoneNumberCountryCode": "1",
      "matches": {
        "lastName": true,
        "firstName": true,
        "dateOfBirth": true,
        "phoneNumber": true,
        "address1": true,
        "address2": null,
        "city": true,
        "state": true,
        "zipCode": true,
        "country": true,
        "phoneSim": null
      },
      "externalId": "A1.bCDE"
    },
    {
      "id": "960b7d8a-1c10-4f9d-a2e0-67c68fe688e7",
      "lastName": "SMITH",
      "documentType": "US_CA_DL",
      "documentNumberSuffix": "5678",
      "createdAt": "2026-05-05T18:01:09Z",
      "verifier": "DMV",
      "verifierResult": "SUCCESS",
      "matches": {
        "lastName": true,
        "firstName": true,
        "middleName": true,
        "middleInitial": true,
        "dateOfBirth": true,
        "documentNumber": true,
        "issueDate": true,
        "expiryDate": true,
        "eyeColor": true,
        "sex": true,
        "address1": true,
        "address2": null,
        "city": true,
        "state": true,
        "zipCode": true,
        "height": true,
        "zip4": null,
        "weight": true,
        "documentType": true
      }
    }
  ],
  "messages": [
    {
      "id": "f2aafebd-8d41-4366-9ead-59e04931c3a8",
      "status": "DELIVERED",
      "createdAt": "2026-05-05T18:00:00Z",
      "channel": "SMS",
      "recipient": "+12025551234",
      "simSwapped": false
    }
  ],
  "devices": [
    {
      "id": "fb125038-2656-4b51-85ad-6a495876f107",
      "platform": "iPhone",
      "language": "en-US",
      "browserTimeZone": "America/Los_Angeles",
      "origin": null,
      "browserDateTime": "Tue May 05 2026 11:00:00 GMT-0700 (Pacific Daylight Time)",
      "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
      "operatingSystem": "iOS 18.5",
      "browser": "Mobile Safari 18.5",
      "displayWidth": 390,
      "displayHeight": 844,
      "browserHeight": 844,
      "browserWidth": 390,
      "ipAddress": "192.0.2.1",
      "ipAddressTimeZone": "America/Los_Angeles",
      "country": "United States",
      "region": "California",
      "city": "San Francisco",
      "isp": "Example ISP, Inc.",
      "createdAt": "2026-05-05T18:00:30Z",
      "latitude": 37.7749,
      "longitude": -122.4194,
      "gpsLatitude": null,
      "gpsLongitude": null,
      "via": [],
      "offsetMinutes": 420,
      "epochMilliseconds": 1778000000000,
      "asn": null,
      "dateTime": "5/5/2026 09:53",
      "browserTimeZoneWithOffset": "America/Los Angeles (-7)",
      "scanCode": "123",
      "linkCode": "1920",
      "scannedDocument": true,
      "blacklistedNetwork": false,
      "whitelistedNetwork": false,
      "truPassUsed": false,
      "fingerprint": "abc123def456ghi789jkl012mno345pqr678stu9",
      "turnstileRobot": null,
      "turnstileError": null
    }
  ],
  "riskScores": [
    {
      "ruleType": "DEVICE",
      "id": "0d98bd5f-7e8d-4430-a048-14775c6e57f9",
      "score": "NO",
      "rule": "DEV4D",
      "reason": "VPN/Proxy - using iCloud Private Relay",
      "type": "DEVICE",
      "riskyFields": [
        "ipAddress"
      ],
      "riskyDevices": [
        "fb125038-2656-4b51-85ad-6a495876f107"
      ],
      "robotRule": true,
      "createdAt": "2026-05-05T18:00:31Z"
    },
    {
      "ruleType": "VERIFIER",
      "id": "ad37692c-0e7b-4eeb-a191-f5ce9cd2bb45",
      "score": "LOW",
      "rule": "VER5A",
      "reason": "Between 1% and 20% of DMV data is incorrect",
      "type": "VERIFIER",
      "riskyFields": [
        "issueDate",
        "expiryDate"
      ],
      "verifier": "DMV",
      "riskyDevices": [],
      "robotRule": false,
      "createdAt": "2026-05-05T18:01:09Z"
    }
  ],
  "billable": true,
  "billableAt": "2026-05-05T18:00:31Z"
}

Messages

Get all messages for a verification

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>

Responses

Response samples

Content type
*/*
[
  {
    "id": "f2aafebd-8d41-4366-9ead-59e04931c3a8",
    "status": "DELIVERED",
    "createdAt": "2026-05-05T18:00:00Z",
    "channel": "SMS",
    "recipient": "+12025551234",
    "simSwapped": false
  }
]

Add a message to a verification

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>
Request Body schema: application/json
required
One of
channel
required
string

Responses

Request samples

Content type
application/json
Example
{
  • "channel": "COPY"
}

Response samples

Content type
*/*
{
  "id": "f2aafebd-8d41-4366-9ead-59e04931c3a8",
  "status": "DELIVERED",
  "createdAt": "2026-05-05T18:00:00Z",
  "channel": "SMS",
  "recipient": "+12025551234",
  "simSwapped": false
}

Get a verification's message by ID

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>
verificationMessageId
required
string <uuid>

Responses

Encrypted Verifications

Create a new verification with encrypted response

Create a new verification and return the verification data encrypted with the provided encryption key.

Authorizations:
bearerAuth
Request Body schema: application/json
required
documentType
required
string
Enum: "US_CA_DL" "UK_DL" "PASSPORT" "INDIA_DL" "INDIA_ID" "INDIA_PAN" "PHILIPPINES_DL" "PHILIPPINES_ID" "PHILIPPINES_MULTI_ID" "US_MILITARY_ID" "US_VETERAN_ID" "SINGAPORE_DL" "SINGAPORE_ID" "SINGAPORE_WORK_PERMIT" "SINGAPORE_EMPLOYMENT_PASS" "PAKISTAN_ID" "AUSTRALIA_DL" "MEXICO_DL" "NETHERLANDS_DL"
callbackUrl
string <uri>
Array of RequestedVerifier (object) or RequestedDmvVerifier (object) or RequestedLexisNexisVerifier (object) or RequestedMnoVerifier (object) unique

Set of verifiers to run against this verification. Each entry uses the 'verifier' discriminator field.

object (VerificationSubject)

Optional identity information about the subject of this verification, used by the ExpectedSubjectVerifier to compare against the scanned document.

Array of RequestedMessage (object) or RequestedCopyMessage (object) or RequestedEmailMessage (object) or RequestedSmsMessage (object) or RequestedTrustedSmsMessage (object) [ 0 .. 2 ] items unique

Set of messages to send for this verification. Each entry uses the 'channel' discriminator field. Maximum 2.

status
string
Value: "CREATED"
object

Public key used for encrypting the verification response. Must be one of RSA, EC or OKP (crv=X25519) type in JWK format.

Responses

Request samples

Content type
application/json
{
  • "documentType": "US_CA_DL",
  • "callbackUrl": "https://example.com/callback/unique/to/this/request/8b62142a99ba759d8c9153b68765513c62180891",
  • "requestedVerifiers": [
    ],
  • "subject": {
    },
  • "requestedMessages": [
    ],
  • "status": "CREATED",
  • "publicWebKey": {
    }
}

Get an encrypted verification by ID

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>

Responses

Get an encrypted document by verification ID

Get the verification's document and return it encrypted with the same public key provided when the verification was created.

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>

Responses

Risk Scores

Get all scores for a verification

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>

Responses

Response samples

Content type
*/*
[
  {
    "ruleType": "DEVICE",
    "id": "0d98bd5f-7e8d-4430-a048-14775c6e57f9",
    "score": "NO",
    "rule": "DEV4D",
    "reason": "VPN/Proxy - using iCloud Private Relay",
    "type": "DEVICE",
    "riskyFields": [
      "ipAddress"
    ],
    "riskyDevices": [
      "fb125038-2656-4b51-85ad-6a495876f107"
    ],
    "robotRule": true,
    "createdAt": "2026-05-05T18:00:31Z"
  },
  {
    "ruleType": "VERIFIER",
    "id": "ad37692c-0e7b-4eeb-a191-f5ce9cd2bb45",
    "score": "LOW",
    "rule": "VER5A",
    "reason": "Between 1% and 20% of DMV data is incorrect",
    "type": "VERIFIER",
    "riskyFields": [
      "issueDate",
      "expiryDate"
    ],
    "verifier": "DMV",
    "riskyDevices": [],
    "robotRule": false,
    "createdAt": "2026-05-05T18:01:09Z"
  }
]

Documents

Get the verification's document

Returns the scanned document data in two forms: 'unmasked' with full PII and 'masked' with sensitive fields partially redacted.

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>

Responses

Response samples

Content type
*/*
{
  "UNMASKED": {
    "documentNumber": "D12345678",
    "dateOfBirth": "03/15/1990",
    "firstName": "JANE",
    "age": "36",
    "lastName": "SMITH",
    "middleName": "MARIE",
    "middleInitial": "M",
    "issueDate": "06/01/2020",
    "expiryDate": "03/15/2028",
    "documentType": "Driver License",
    "sex": "Female",
    "eyeColor": "Brown",
    "height": "64",
    "weight": "130",
    "address1": "123 MAIN ST",
    "address2": null,
    "city": "LOS ANGELES",
    "state": "CA",
    "zipCode": "90001",
    "zip4": null,
    "nationality": "UNITED STATES OF AMERICA",
    "iso3CountryCode": "USA",
    "iso2CountryCode": "US",
    "isoCountryName": "United States of America",
    "issuingAuthority": null,
    "placeOfBirth": null,
    "verifiedMrz": null,
    "fullAddress": "123 MAIN ST, LOS ANGELES, CA, 90001",
    "suffix": null,
    "documentCategory": null,
    "documentJurisdiction": null,
    "phoneNumber": null,
    "version": "V1"
  },
  "MASKED": {
    "documentNumber": "D12*******",
    "dateOfBirth": "03/*******",
    "firstName": "JANE",
    "age": "**********",
    "lastName": "SMITH",
    "middleName": "MARIE",
    "middleInitial": "M",
    "issueDate": "06/*******",
    "expiryDate": "03/*******",
    "documentType": "Driver License",
    "sex": "**********",
    "eyeColor": "**********",
    "height": "**********",
    "weight": "**********",
    "address1": "123*******",
    "address2": null,
    "city": "LOS*******",
    "state": "C*********",
    "zipCode": "900*******",
    "zip4": null,
    "nationality": "UNI*******",
    "iso3CountryCode": "U*********",
    "iso2CountryCode": "U*********",
    "isoCountryName": "United States of America",
    "issuingAuthority": null,
    "placeOfBirth": null,
    "verifiedMrz": null,
    "fullAddress": "123*******",
    "suffix": null,
    "documentCategory": null,
    "documentJurisdiction": null,
    "phoneNumber": null,
    "version": "V1"
  }
}

Get the scanned image of the document

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>

Responses

Devices

Get all devices for a verification

Authorizations:
bearerAuth
path Parameters
verificationId
required
string <uuid>

Responses

Response samples

Content type
*/*
[
  {
    "id": "fb125038-2656-4b51-85ad-6a495876f107",
    "platform": "iPhone",
    "language": "en-US",
    "browserTimeZone": "America/Los_Angeles",
    "origin": null,
    "browserDateTime": "Tue May 05 2026 11:00:00 GMT-0700 (Pacific Daylight Time)",
    "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
    "operatingSystem": "iOS 18.5",
    "browser": "Mobile Safari 18.5",
    "displayWidth": 390,
    "displayHeight": 844,
    "browserHeight": 844,
    "browserWidth": 390,
    "ipAddress": "192.0.2.1",
    "ipAddressTimeZone": "America/Los_Angeles",
    "country": "United States",
    "region": "California",
    "city": "San Francisco",
    "isp": "Example ISP, Inc.",
    "createdAt": "2026-05-05T18:00:30Z",
    "latitude": 37.7749,
    "longitude": -122.4194,
    "gpsLatitude": null,
    "gpsLongitude": null,
    "via": [],
    "offsetMinutes": 420,
    "epochMilliseconds": 1778000000000,
    "asn": null,
    "dateTime": "5/5/2026 09:53",
    "browserTimeZoneWithOffset": "America/Los Angeles (-7)",
    "scanCode": "123",
    "linkCode": "1920",
    "scannedDocument": true,
    "blacklistedNetwork": false,
    "whitelistedNetwork": false,
    "truPassUsed": false,
    "fingerprint": "abc123def456ghi789jkl012mno345pqr678stu9",
    "turnstileRobot": null,
    "turnstileError": null
  }
]