Transaction

Get transaction data

Retrieves detailed information for a verification process by transaction identifier.

get/api/transactions/{transactionId}

Request

  • Base URL
    https://verification.trulioo.com
  • URL
    https://verification.trulioo.com/api/transactions/{transactionId}
  • Auth
    HTTP bearer

Path parameters

transactionIdstring uuid required

Headers

Accept-Versionstring required
Example:3.0

API version header.

Response

OK

transactionIdstring uuid

Unique identifier of the transaction.

clientIdstring

Client-provided identifier for correlation.

timeOfTransactionstring date-time

ISO 8601 timestamp when the transaction took place.

status'ACCEPTED' | 'REVIEW' | 'DECLINED' | 'ERROR' | 'NO_RESULT'

Decision of the verification.

errorsstring[]

Errors related to image processing or vendor interactions.

uniquePersonIdentifierstring

Identifier of a customer who has enrolled their selfie successfully.

Example response

{
  "transactionId": "28087e85-9c6c-4ce9-83e2-1fb3d66b8cde",
  "clientId": "8005efed-e683-40ab-a803-56eba164b767",
  "timeOfTransaction": "2023-01-01T16:00:00Z",
  "status": "REVIEW",
  "indicators": [
    {
      "type": "DOCUMENT",
      "result": "REVIEW",
      "description": "Document requires a review.",
      "score": "90",
      "subindicators": [
        {
          "type": "BARCODE",
          "result": "NOT_RUN",
          "description": "Check was skipped.",
          "code": "BARCODE_INTEGRITY"
        }
      ]
    }
  ],
  "person": {
    "fullName": "Sherlock Holmes",
    "firstName": "Sherlock",
    "middleName": "Scott",
    "lastName": "Holmes",
    "dateOfBirth": "1859-05-22",
    "placeOfBirth": "London",
    "nationality": "England",
    "gender": "F",
    "location": {
      "fullAddress": "221b Baker St, London, England, NW16XE",
      "addressLine1": "221b Baker St",
      "addressLine2": "London, State, NW16XE",
      "city": "London",
      "stateProvince": "State",
      "country": "England",
      "zipCode": "NW16XE"
    },
    "standardizedLocation": {
      "fullAddress": "221b Baker St, London, England, NW16XE",
      "addressLine1": "221b Baker St",
      "addressLine2": "London, State, NW16XE",
      "city": "London",
      "stateProvince": "State",
      "country": "England",
      "zipCode": "NW16XE"
    },
    "alternateFirstName": "小明",
    "alternateMiddleName": "大",
    "alternateLastName": "王",
    "alternateFullName": "王大小明",
    "alternateDateOfBirth": "πρώτος Ιανουαρίου",
    "alternateLocation": {
      "fullAddress": "1234バンクーバー通り, バンクーバー, ブリティッシュコロンビア, カナダ, NW16XE",
      "addressLine1": "1234バンクーバー通り",
      "addressLine2": "バンクーバー",
      "city": "バンクーバー",
      "stateProvince": "ブリティッシュコロンビア",
      "country": "カナダ",
      "zipCode": "מיקוד"
    },
    "firstLastName": "Silva",
    "secondLastName": "Pereira",
    "alternateFirstLastname": "司",
    "alternateSecondLastName": "徒",
    "birthLastName": "Holmes",
    "spouseLastName": "Smith",
    "estimatedMinAge": 23,
    "estimatedMaxAge": 25
  },
  "document": {
    "documentName": "Australia - ePassport (2009) Travel Document",
    "dlCategory": "Class 5",
    "documentNumber": "EX504966",
    "documentNumber2": "A09354726",
    "documentNumber3": "C07321129",
    "documentNumber4": "D06364026",
    "documentCountry": "GB",
    "jurisdictionCode": "ENG",
    "issueDate": "2020-11-17T00:00:00Z",
    "expirationDate": "2030-11-17T00:00:00Z",
    "alternateDocumentNumber": "一百二十三萬四千五百六十七",
    "alternateDocumentNumber2": "一百二十三萬四千五百六十七",
    "alternateDocumentNumber3": "一百二十三萬四千五百六十七",
    "alternateDocumentNumber4": "一百二十三萬四千五百六十七",
    "alternateExpiryDate": "2050 年 1 月 1 日",
    "alternateIssueDate": "2000 年 1 月 1 日",
    "mrzLineOne": "PASGPLEE<<ZHEN<CHENG<<<<<<<<<<<<<<<<<<<<<<<<",
    "mrzLineTwo": "K1167647Z7SGP9112090M2412137S9146294Z<<<<<22",
    "mrzLineThree": "K1167647Z7SGP9112090M2412137S9146294Z<<<<<22"
  },
  "matcherResults": [
    {
      "results": [
        {
          "matcherToken": {
            "pii": {
              "customerInput": "JOHN",
              "ocrInput": "JOHN"
            }
          },
          "resultPrecision": "EXACT_MATCH"
        }
      ],
      "active": true
    }
  ],
  "knownFacesMatches": [
    {
      "transactionId": "811dd5c2-dfa1-493e-bfe7-502385f5a0fc",
      "similarityScore": 88.5,
      "normalizedSimilarityScore": 65,
      "status": "REVIEW",
      "timeOfTransaction": "2023-01-01T16:00:00.000Z",
      "selfieUrl": "https://verification.trulioo.io/admin/transactions/28087e85-9c6c-4ce9-83e2-1fb3d66b8cde/images/f12885ea-699f-4572-8630-cddc01e8a929?authorization=eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0.eyJleGFtcGxlIjoidGhpcy1pcy1hLWZha2UtdG9rZW4iLCJ1c2UiOiJkb2N1bWVudGF0aW9uIn0"
    }
  ],
  "biometricVerification": {
    "enrolment": {
      "uniquePersonIdentifier": "4a86fdb0-1839-4e2c-b880-9b0bb9c47650",
      "enrolledImageId": "ffa25d31-e16d-48e4-90be-4124b425154d",
      "timeOfEnrolment": "2025-07-03T21:49:30.903Z",
      "livenessScore": "99",
      "enrolledImagesCount": 1,
      "externalUniquePersonIdentifier": "c52ae4f9-e99d-430f-a776-203f358ef1e4"
    },
    "verification": {
      "uniquePersonIdentifier": "4a86fdb0-1839-4e2c-b880-9b0bb9c47650",
      "selfieImageId": "0757409e-61ee-49e6-b6d9-f0f3b9682053",
      "verificationType": "MATCH",
      "imagesComparedCount": 1,
      "externalUniquePersonIdentifier": "c52ae4f9-e99d-430f-a776-203f358ef1e4",
      "matchedImages": [
        {
          "imageId": "ffa25d31-e16d-48e4-90be-4124b425154d",
          "imageCapturedTime": "2025-07-03T21:49:30.903Z",
          "score": "46",
          "source": "API"
        }
      ]
    }
  },
  "uniquePersonIdentifier": "ede60aad-b484-484c-8f31-9c51e55efe67",
  "networkInsight": [
    {
      "transactionId": "4a86fdb0-1839-4e2c-b880-9b0bb9c47650",
      "status": "Accepted",
      "timestamp": "2025-07-03T21:49:30.903999812Z",
      "matchCount": 6,
      "channel": "SDK",
      "networkInsightData": {
        "person": true,
        "document": true,
        "standardizedAddress": true,
        "ipAddress": true,
        "knownFace": true,
        "personState": "match",
        "standardizedAddressState": "missing",
        "ipAddressState": "nomatch",
        "documentState": "match",
        "knownFaceState": "missing"
      }
    }
  ],
  "attributeVelocity": {
    "person": {
      "count1h": 3,
      "count24h": 5,
      "count7d": 8,
      "countAllTime": 8
    },
    "document": {
      "count1h": 3,
      "count24h": 5,
      "count7d": 8,
      "countAllTime": 8
    },
    "knownFace": {
      "count1h": 3,
      "count24h": 5,
      "count7d": 8,
      "countAllTime": 8
    },
    "ipAddress": {
      "count1h": 3,
      "count24h": 5,
      "count7d": 8,
      "countAllTime": 8
    },
    "address": {
      "count1h": 3,
      "count24h": 5,
      "count7d": 8,
      "countAllTime": 8
    }
  },
  "alerts": [
    {
      "label": "Document_Velocity",
      "drivers": [
        "DOCUMENT_HIGH_ACTIVITY_1H"
      ],
      "contributingTxnIds": [
        "txn-1",
        "txn-2",
        "txn-3"
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.