---
updatedAt: 2026-04-28T18:31:13.000Z
agentTools:
  projectIndex: https://developer.trulioo.com/llms.txt
---

# Get the data of a transaction

Retrieves the detailed information of a verification process specified by a transaction identifier.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Customer API",
    "version": "2.4",
    "description": "The Trulioo Customer API is organized around REST. Our API has predictable resource-oriented URLs and uses standard HTTP response codes, authentication, and verbs. The API provides authorization endpoints and endpoints to perform document verification and review transaction results.\n<br />\n> Some US states impose obligations on businesses that collect and use “biometric identifiers” and/or “biometric information”, which may include facial scan data extracted from photos during a document verification transaction. One such law is the Illinois Biometric Information Privacy Act (“BIPA”). A business required to comply with BIPA is under obligations to, among other things, ensure that it informs the individual of the purpose of the collection and obtain consent. Accordingly, we require a notice and consent mechanism be implemented for all document verification transactions, and our customers using our API must provide us with confirmation via API whether an individual is located in the United States and has consented to the transaction in the prescribed manner. We also strongly encourage all of our customers to consult with legal counsel to ensure their own compliance with such laws. <br />  <br /> For more information about the required notice and consent mechanism, please refer to our [Service Specific Terms](https://www.trulioo.com/legal/SST) for Document Verification. <br />  <br /> You can read more about the configuration requirements for our API related to the notice and consent mechanism [here](#tag/Audit/operation/post-customer-audit-record-consent)."
  },
  "servers": [
    {
      "url": "https://verification.trulioo.com",
      "description": "production"
    }
  ],
  "tags": [
    {
      "name": "Transaction"
    }
  ],
  "security": [
    {
      "AccessToken": []
    }
  ],
  "paths": {
    "/customer/transactions/{transactionId}": {
      "get": {
        "tags": [
          "Transaction"
        ],
        "summary": "Get the data of a transaction",
        "operationId": "get_transaction_data",
        "description": "Retrieves the detailed information of a verification process specified by a transaction identifier.",
        "parameters": [
          {
            "schema": {
              "type": "string"
            },
            "name": "transactionId",
            "in": "path",
            "required": true
          },
          {
            "in": "header",
            "name": "Accept-Version",
            "description": "API Version",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransactionResultResponse"
                }
              }
            },
            "headers": {
              "Accept-Version": {
                "schema": {
                  "type": "string"
                },
                "description": "API Version of the response"
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/UnauthorizedError"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "AccessToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "JWT token of type access"
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad Request",
        "headers": {
          "Accept-Version": {
            "schema": {
              "type": "string"
            },
            "description": "API Version of the response"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "messsage": {
                  "type": "string",
                  "default": "Make sure your request is formatted correctly."
                }
              }
            }
          }
        }
      },
      "UnauthorizedError": {
        "description": "Unauthorized \n \n `default`: Jwt is expired",
        "content": {
          "text/plain": {
            "schema": {
              "type": "string",
              "default": "Jwt is expired"
            }
          }
        }
      },
      "NotFound": {
        "description": "Not Found",
        "headers": {
          "Accept-Version": {
            "schema": {
              "type": "string",
              "description": "API Version of the response"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "default": "Check if the transactionId is correct."
                }
              }
            }
          }
        }
      },
      "InternalError": {
        "description": "Internal Server Error",
        "headers": {
          "Accept-Version": {
            "schema": {
              "type": "string",
              "description": "API Version of the response"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "default": "The server encountered an error. Please email us at support@trulioo.com."
                }
              }
            }
          }
        }
      }
    },
    "schemas": {
      "TransactionResultResponse": {
        "title": "TransactionResultResponse",
        "type": "object",
        "properties": {
          "transactionId": {
            "type": "string",
            "description": "The unique identifier of a Trulioo document verification transaction.",
            "example": "28087e85-9c6c-4ce9-83e2-1fb3d66b8cde"
          },
          "dataVendorSessionId": {
            "type": "string",
            "description": "The unique identifier referencing a specific vendor verification session.",
            "example": "8005efed-e683-40ab-a803-56eba164b767"
          },
          "timeOfTransaction": {
            "type": "string",
            "description": "Date and time (ISO 8601) when the transaction took place.",
            "example": "2023-01-01T16:00:00.000Z"
          },
          "status": {
            "type": "string",
            "description": "The decision of the verification.",
            "enum": [
              "ACCEPTED",
              "REVIEW",
              "DECLINED",
              "ERROR",
              "NO_RESULT"
            ],
            "example": "REVIEW"
          },
          "errors": {
            "type": "array",
            "description": "List of errors related to image processing, network with vendor, or vendor errors during verification.",
            "items": {
              "type": "string"
            }
          },
          "indicators": {
            "type": "array",
            "description": "Reasons of verification failure.",
            "items": {
              "$ref": "#/components/schemas/Indicator"
            }
          },
          "person": {
            "$ref": "#/components/schemas/Person"
          },
          "document": {
            "$ref": "#/components/schemas/Document"
          },
          "images": {
            "$ref": "#/components/schemas/ImageIds"
          }
        }
      },
      "Address": {
        "title": "Address",
        "type": "object",
        "properties": {
          "fullAddress": {
            "type": "string",
            "example": "221b Baker St, London, England, NW16XE"
          },
          "addressLine1": {
            "type": "string",
            "example": "221b Baker St"
          },
          "addressLine2": {
            "type": "string",
            "example": "London, State, NW16XE"
          },
          "city": {
            "type": "string",
            "example": "London"
          },
          "stateProvince": {
            "type": "string",
            "example": "State"
          },
          "country": {
            "type": "string",
            "example": "England"
          },
          "zipCode": {
            "type": "string",
            "example": "NW16XE"
          }
        }
      },
      "Person": {
        "title": "Person",
        "type": "object",
        "properties": {
          "fullName": {
            "type": "string",
            "description": "Full name of the subject/applicant. Used in case of indistinguishable first and last name",
            "example": "Sherlock Holmes"
          },
          "firstName": {
            "type": "string",
            "example": "Sherlock"
          },
          "middleName": {
            "type": "string",
            "example": "Scott"
          },
          "lastName": {
            "type": "string",
            "example": "Holmes"
          },
          "dateOfBirth": {
            "type": "string",
            "description": "Date of birth of the subject/applicant (ISO 8601)",
            "example": "1859-05-22"
          },
          "placeOfBirth": {
            "type": "string",
            "description": "Place of birth of the subject/applicant",
            "example": "London"
          },
          "nationality": {
            "type": "string",
            "description": "A person's nationality.",
            "example": "England"
          },
          "gender": {
            "type": "string",
            "description": "Person's gender as denoted by the letters M for male or F for female.",
            "example": "F"
          },
          "location": {
            "$ref": "#/components/schemas/Address"
          },
          "alternateFirstName": {
            "type": "string",
            "description": "First name that is non-iso latin",
            "example": "小明"
          },
          "alternateMiddleName": {
            "type": "string",
            "description": "Middle name that is non-iso latin",
            "example": "大"
          },
          "alternateLastName": {
            "type": "string",
            "description": "Middle name that is non-iso latin",
            "example": "王"
          },
          "alternateFullName": {
            "type": "string",
            "description": "Full name that is non-iso latin",
            "example": "王大小明"
          },
          "alternateDateOfBirth": {
            "type": "string",
            "example": "πρώτος Ιανουαρίου"
          },
          "alternateLocation": {
            "type": "object",
            "properties": {
              "fullAddress": {
                "type": "string",
                "example": "1234バンクーバー通り, バンクーバー, ブリティッシュコロンビア,  カナダ, NW16XE"
              },
              "addressLine1": {
                "type": "string",
                "description": "Address line 1 that is non-iso latin",
                "example": "1234バンクーバー通り"
              },
              "addressLine2": {
                "type": "string",
                "description": "Address line 2 that is non-iso latin",
                "example": "バンクーバー"
              },
              "city": {
                "type": "string",
                "example": "バンクーバー"
              },
              "stateProvince": {
                "type": "string",
                "example": "ブリティッシュコロンビア"
              },
              "country": {
                "type": "string",
                "example": "カナダ"
              },
              "zipCode": {
                "type": "string",
                "example": "מיקוד"
              }
            }
          },
          "standardizedLocation": {
            "$ref": "#/components/schemas/Address"
          },
          "firstLastName": {
            "type": "string",
            "example": "Silva"
          },
          "secondLastname": {
            "type": "string",
            "example": "Pereira"
          },
          "alternateFirstLastname": {
            "type": "string",
            "example": "司"
          },
          "alternateSecondLastname": {
            "type": "string",
            "example": "徒"
          },
          "birthLastName": {
            "type": "string",
            "description": "Last name by birth",
            "example": "Holmes"
          },
          "spouseLastName": {
            "type": "string",
            "description": "Last name of spouse",
            "example": "Smith"
          },
          "estimatedMinAge": {
            "type": "integer",
            "nullable": true,
            "description": "Minimum estimated age. Null when age estimation did not run; 0 when it ran but errored.",
            "example": 23
          },
          "estimatedMaxAge": {
            "type": "integer",
            "nullable": true,
            "description": "Maximum estimated age. Null when age estimation did not run; 0 when it ran but errored.",
            "example": 25
          }
        }
      },
      "Document": {
        "title": "Document",
        "type": "object",
        "properties": {
          "documentType": {
            "type": "string",
            "description": "Type of the identification document provided.",
            "enum": [
              "PASSPORT",
              "DRIVERS_LICENSE",
              "ID_CARD",
              "RESIDENCE_PERMIT",
              "MILITARY_ID",
              "VISA",
              "HEALTH_CARD",
              "TRAVEL_DOCUMENT",
              "VOTER_ID",
              "OTHER",
              "UNKNOWN",
              "UNSUPPORTED",
              "NOT_STARTED",
              "ERROR",
              ""
            ]
          },
          "documentName": {
            "type": "string",
            "example": "Australia - ePassport (2009) Travel Document"
          },
          "dlCategory": {
            "type": "string",
            "description": "The driving license category if the submitted document is of type DRIVERS_LICENSE",
            "example": "Class 5"
          },
          "documentNumber": {
            "type": "string",
            "description": "The primary document identifier apparent in all documents.",
            "example": "EX504966"
          },
          "documentNumber2": {
            "type": "string",
            "description": "The second document identifier that is apparent in some documents.",
            "example": "A09354726"
          },
          "documentNumber3": {
            "type": "string",
            "description": "The third document identifier that is apparent in some documents.",
            "example": "C07321129"
          },
          "documentNumber4": {
            "type": "string",
            "description": "The fourth document identifier that is apparent in some documents.",
            "example": "D06364026"
          },
          "documentCountry": {
            "type": "string",
            "description": "The ISO alpha-2 code of issuing country of the document.",
            "example": "GB"
          },
          "jurisdictionCode": {
            "type": "string",
            "description": "The code of issuing jurisdiction of the document.",
            "example": "ENG"
          },
          "issueDate": {
            "type": "string",
            "description": "Date at which document is issued by a governing body.",
            "example": "2020-11-17T00:00:000Z"
          },
          "expirationDate": {
            "type": "string",
            "description": "Date at which document will or has expired.",
            "example": "2030-11-17T00:00:000Z"
          },
          "alternateDocumentNumber": {
            "type": "string",
            "description": "Document number that is non-iso latin",
            "example": "一百二十三萬四千五百六十七"
          },
          "alternateDocumentNumber2": {
            "type": "string",
            "description": "Document number that is non-iso latin",
            "example": "一百二十三萬四千五百六十七"
          },
          "alternateDocumentNumber3": {
            "type": "string",
            "description": "Document number that is non-iso latin",
            "example": "一百二十三萬四千五百六十七"
          },
          "alternateDocumentNumber4": {
            "type": "string",
            "description": "Document number that is non-iso latin",
            "example": "一百二十三萬四千五百六十七"
          },
          "alternateExpiryDate": {
            "type": "string",
            "description": "Expiry date that is non-iso latin",
            "example": "2050 年 1 月 1 日"
          },
          "alternateIssueDate": {
            "type": "string",
            "description": "Issue date that is non-iso latin",
            "example": "2000 年 1 月 1 日"
          }
        }
      },
      "Indicator": {
        "title": "Indicator",
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "DOCUMENT",
              "FACE_MATCH",
              "LIVENESS"
            ],
            "example": "DOCUMENT"
          },
          "result": {
            "type": "string",
            "enum": [
              "ACCEPTED",
              "DECLINED",
              "REVIEW",
              "ERROR",
              "NO_RESULT"
            ],
            "example": "REVIEW"
          },
          "description": {
            "type": "string",
            "example": "Document requires a review."
          },
          "score": {
            "type": "string",
            "example": "90"
          },
          "subindicators": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Subindicator"
            }
          }
        }
      },
      "Subindicator": {
        "title": "Subindicator",
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "example": "OCR"
          },
          "result": {
            "type": "string",
            "enum": [
              "ACCEPTED",
              "DECLINED",
              "REVIEW",
              "ERROR",
              "NO_RESULT"
            ],
            "example": "REVIEW"
          },
          "description": {
            "type": "string",
            "example": "Poor image quality."
          }
        }
      },
      "ImageIds": {
        "title": "Images",
        "type": "object",
        "description": "The object contain all submitted images.",
        "properties": {
          "frontDocumentId": {
            "type": "string",
            "example": "0116879a-ff2d-4c58-96da-fb4f088452e7"
          },
          "backDocumentId": {
            "type": "string",
            "example": "78b65b2a-72ee-4b81-a14b-e795cedbc818"
          },
          "selfieId": {
            "type": "string",
            "example": "f12885ea-699f-4572-8630-cddc01e8a929"
          },
          "accessToken": {
            "type": "string",
            "description": "The short lived access token in the format of JWT which contains ID of images. This access token is used as authorization token to retrieve images."
          },
          "documentFrontUrl": {
            "type": "string",
            "description": "URL to download document front image."
          },
          "documentBackUrl": {
            "type": "string",
            "description": "URL to download document back image."
          },
          "selfieUrl": {
            "type": "string",
            "description": "URL to download selfie image."
          }
        }
      }
    }
  }
}
```