--- title: "Get transaction data" method: GET path: "/api/transactions/{transactionId}" tags: ["Transaction"] --- # Get transaction data `GET /api/transactions/{transactionId}` ## Request - Base URL: `https://verification.trulioo.com` - URL: `https://verification.trulioo.com/api/transactions/{transactionId}` - Auth: HTTP bearer Retrieves detailed information for a verification process by transaction identifier. ## Path parameters - `transactionId` string, uuid, required ## Headers - `Accept-Version` string, required ## Response `200` OK - TransactionResultResponse - `transactionId` string, uuid: Unique identifier of the transaction. - `clientId` string: Client-provided identifier for correlation. - `timeOfTransaction` string, date-time: ISO 8601 timestamp when the transaction took place. - `status` 'ACCEPTED' | 'REVIEW' | 'DECLINED' | 'ERROR' | 'NO_RESULT': Decision of the verification. - `errors` string[]: Errors related to image processing or vendor interactions. - `indicators` Indicator[]: Reasons for verification outcome. - `type` 'DOCUMENT' | 'FACE_MATCH' | 'LIVENESS' | 'BIOMETRIC_AUTHENTICATION' - `result` 'ACCEPTED' | 'DECLINED' | 'REVIEW' | 'ERROR' | 'NO_RESULT' - `description` string - `score` string - `subindicators` Subindicator[] - `type` 'UNKNOWN_TYPE' | 'BARCODE' | 'CLASSIFIED_DOCUMENT' | 'INPUT_MATCH' | 'DIFFERENT_DOCUMENTS' | 'DOCUMENT_LIVENESS' | 'DOCUMENT_XCHECK' | 'FACE_MATCH' | 'IMAGE_QUALITY' | 'LIVENESS' | 'MRZ' | 'PRESENTATION_ATTACK' | 'SECURITY_FEATURES' | 'TAMPERING' | 'VALID_DOCUMENT' | 'FACE_IMAGE_QUALITY' | 'DATA_MATCH' | 'MAPPING_ERROR' | 'BIOMETRIC_VERIFICATION' - `result` 'ACCEPTED' | 'DECLINED' | 'REVIEW' | 'ERROR' | 'NO_RESULT' | 'NOT_RUN' | 'PENDING_RESULT' - `description` string - `code` 'UNKNOWN_CODE' | 'BARCODE_INTEGRITY' | 'DOCUMENT_CONDITION' | 'DOCUMENT_LIVENESS_RESULT' | 'SINGLE_DOCUMENT_DETECTED' | 'DOCUMENT_DETECTED' | 'ALL_DOCUMENT_SIDES_CAPTURED' | 'DOCUMENT_CORNERS_VISIBLE' | 'DOCUMENT_STATUS' | 'DOCUMENT_TAMPERING' | 'EXPIRY' | 'FACE_LIVENESS_QUALITY' | 'FACE_LIVENESS' | 'FACE_MATCH_VERIFICATION' | 'FRONT_BACK_MATCH' | 'IMAGE_QUALITY_RESULT' | 'INPUT_MATCH_RESULT' | 'PHOTOS_STREAMED' | 'PHOTOS_STREAMED_M2' | 'CLIENT_CONNECTION_VARIATION' | 'ISSUE_DATE_UNDER_10Y' | 'MRZ_VALIDITY' | 'PRINTOUT' | 'SCREEN_REPLAY' | 'SECURITY_FEATURES_RESULT' | 'SUPPORTED_DOC_TYPE' | 'TEXT_VALIDITY_GENERIC' | 'TEXT_VALIDITY_VALID_CHARS' | 'TEXT_VALIDITY_ADDRESS' | 'TEXT_VALIDITY_DOB' | 'TEXT_VALIDITY_DOC_NUM' | 'TEXT_VALIDITY_EXPIRY' | 'TEXT_VALIDITY_GENDER' | 'TEXT_VALIDITY_GIVEN_NAME' | 'TEXT_VALIDITY_ISSUE_DATE' | 'TEXT_VALIDITY_FULL_NAME' | 'TEXT_VALIDITY_SURNAME' | 'TEXT_VALIDITY_COUNTRY' | 'TXN_CONFIG_COUNTRY' | 'TXN_CONFIG_JURISDICTION' | 'XCHECK_REFERENCE_ADDRESS' | 'XCHECK_REFERENCE_DOB' | 'XCHECK_REFERENCE_DOC_NUM' | 'XCHECK_REFERENCE_EXPIRY' | 'XCHECK_REFERENCE_GENDER' | 'XCHECK_REFERENCE_GIVEN_NAME' | 'XCHECK_REFERENCE_ISSUE_DATE' | 'XCHECK_REFERENCE_FULL_NAME' | 'XCHECK_REFERENCE_SURNAME' | 'XCHECK_REFERENCE_COUNTRY' | 'XCHECK_REFERENCE_GENERIC' | 'PORTRAIT_SUBSTITUTION' | 'FACE_TO_CAMERA_DISTANCE' | 'EYES_OPEN' | 'FACE_TO_BORDER_DISTANCE' | 'FACE_NOT_CROPPED' | 'FACE_NOT_OCCLUDED' | 'FACE_DETECTED' | 'FACE_COUNT' | 'FACE_SIZE' | 'FACE_ANGLE' | 'JURISDICTION_PRESENT' | 'INPUT_MATCH_PRESENT' | 'TEXT_FIELD_AVAILABLE' | 'TXN_CONFIG_DOCTYPE' | 'INTERNAL_CODE_MAPPING' | 'VENDOR_CODE_MAPPING' | 'BIOMETRIC_MATCH' - `person` Person - `fullName` string: Full name of the subject/applicant. - `firstName` string - `middleName` string - `lastName` string - `dateOfBirth` string, date: Date of birth (YYYY-MM-DD). - `placeOfBirth` string: Place of birth. - `nationality` string: Nationality. - `gender` 'M' | 'F' | 'X' | 'U': Gender code. - `location` Address - `fullAddress` string - `addressLine1` string - `addressLine2` string - `city` string - `stateProvince` string - `country` string - `zipCode` string - `standardizedLocation` Address - `fullAddress` string - `addressLine1` string - `addressLine2` string - `city` string - `stateProvince` string - `country` string - `zipCode` string - `alternateFirstName` string: First name in non-Latin script. - `alternateMiddleName` string: Middle name in non-Latin script. - `alternateLastName` string: Last name in non-Latin script. - `alternateFullName` string: Full name in non-Latin script. - `alternateDateOfBirth` string: Date of birth in non-Latin script (localized). - `alternateLocation` object - `fullAddress` string - `addressLine1` string - `addressLine2` string - `city` string - `stateProvince` string - `country` string - `zipCode` string - `firstLastName` string - `secondLastName` string - `alternateFirstLastname` string - `alternateSecondLastName` string - `birthLastName` string: Last name by birth. - `spouseLastName` string: Last name of spouse. - `estimatedMinAge` integer, nullable: Minimum estimated age. Null when age estimation did not run; 0 when it ran but errored. - `estimatedMaxAge` integer, nullable: Maximum estimated age. Null when age estimation did not run; 0 when it ran but errored. - `document` Document - `documentType` 'PASSPORT' | 'DRIVERS_LICENSE' | 'ID_CARD' | 'RESIDENCE_PERMIT' | 'MILITARY_ID' | 'VISA' | 'HEALTH_CARD' | 'TRAVEL_DOCUMENT' | 'VOTER_ID' | 'TAX_ID' | 'OTHER' | 'UNKNOWN' | 'UNSUPPORTED' | 'NOT_STARTED' | 'ERROR' | '': Type of the identification document provided. - `documentName` string - `dlCategory` string: License class if documentType is DRIVERS_LICENSE. - `documentNumber` string: Primary document identifier. - `documentNumber2` string - `documentNumber3` string - `documentNumber4` string - `documentCountry` string: ISO 3166-1 alpha-2 issuing country code. - `jurisdictionCode` string: For US/CA driver's licenses and similar: two-letter postal code (e.g., US CA → "CA", Canada British Columbia → "BC"). Not ISO-3166-2 code. - `issueDate` string, date-time: Issue date/time. - `expirationDate` string, date-time: Expiry date/time. - `alternateDocumentNumber` string: Document number in non-Latin script. - `alternateDocumentNumber2` string - `alternateDocumentNumber3` string - `alternateDocumentNumber4` string - `alternateExpiryDate` string: Expiry date in non-Latin script. - `alternateIssueDate` string: Issue date in non-Latin script. - `mrzLineOne` string: First MRZ line. - `mrzLineTwo` string: Second MRZ line. - `mrzLineThree` string: Third MRZ line. - `images` ImageIds: URLs to download submitted images. - `documentFrontUrl` string, uri: URL to download document front image. - `documentBackUrl` string, uri: URL to download document back image. - `selfieUrl` string, uri: URL to download selfie image. - `enrolSelfieUrl` string, uri: URL to download enrolled selfie image. - `matcherResults` MatcherResult[]: Results from user-input matching in the workflow. - `results` Results[] - `matcherToken` MatcherToken - `token` 'FIRST_NAME' | 'LAST_NAME' | 'MIDDLE_NAME' | 'FULL_NAME' | 'DATE_OF_BIRTH' | 'ADDRESS_LINE_1' | 'CITY' | 'STATE_PROVINCE' | 'POSTAL_CODE' | 'COUNTRY' | 'FIRST_LAST_NAME' | 'SECOND_LAST_NAME' | 'SPOUSE_LAST_NAME' | 'BIRTH_LAST_NAME' - `pii` object - `customerInput` string - `ocrInput` string - `precision` 'EXACT_MATCH' | 'HIGH_PARTIAL_MATCH' | 'PARTIAL_MATCH' | 'POOR_MATCH' | 'NO_MATCH' - `resultPrecision` 'EXACT_MATCH' | 'HIGH_PARTIAL_MATCH' | 'PARTIAL_MATCH' | 'POOR_MATCH' | 'NO_MATCH' - `description` string: Error or explanation message. - `active` boolean - `knownFacesMatches` KnownFaces[]: List of known faces matches whose selfie images matched the target selfie - `transactionId` string - `similarityScore` number: Similarity score to the target selfie, between 0.0 to 100.0 - `normalizedSimilarityScore` integer: Normalized version of the similarity score, between 0 and 100 - `status` 'ACCEPTED' | 'DECLINED' | 'REVIEW' | 'ERROR' | 'NO_RESULT' | 'PENDING_RESULT': The decision of the verification. - `timeOfTransaction` string: Date and time (ISO 8601) when the transaction was completed. - `selfieUrl` string: URL to directly access the image, constructed from the transactionId, selfieUrl, and accessToken from this endpoint call. - `biometricVerification` BiometricVerification - `enrolment` Enrolment - `uniquePersonIdentifier` string - `enrolledImageId` string, uuid - `timeOfEnrolment` string, date-time - `livenessScore` string - `enrolledImagesCount` integer - `externalUniquePersonIdentifier` string - `verification` BiometricVerificationResult - `uniquePersonIdentifier` string - `selfieImageId` string, uuid - `verificationType` 'MATCH' | 'NO_MATCH' | 'ERROR' - `imagesComparedCount` integer - `externalUniquePersonIdentifier` string - `matchedImages` MatchedImages[] - `imageId` string, uuid - `imageCapturedTime` string, date-time - `score` string - `source` 'API' | 'SDK' - `uniquePersonIdentifier` string: Identifier of a customer who has enrolled their selfie successfully. - `knownFacesManageLists` KnownFacesManageList[]: List IDs and names associated with this transaction - `listId` string: Manage list identifier - `listName` string: Manage list name - `networkInsight` TransactionNetworkInsight[]: Bounded newest-first network insight evidence associated with this transaction. This read-time evidence view remains capped at 100 rows and visible rows may later resolve to `missing` if the historical evidence expires. - `transactionId` string - `status` string - `timestamp` string - `matchCount` integer - `channel` string: Indicates the integration channel used to process the transaction (e.g., SDK or API). - `networkInsightData` NetworkInsightData - `person` boolean - `document` boolean - `standardizedAddress` boolean - `ipAddress` boolean - `knownFace` boolean - `personState` 'match' | 'nomatch' | 'missing' - `standardizedAddressState` 'match' | 'nomatch' | 'missing' - `ipAddressState` 'match' | 'nomatch' | 'missing' - `documentState` 'match' | 'nomatch' | 'missing' - `knownFaceState` 'match' | 'nomatch' | 'missing' - `attributeVelocity` AttributeVelocity: Assembly-time snapshot of bounded network insight match counts grouped by attribute. - `person` AttributeVelocityCounts - `count1h` integer - `count24h` integer - `count7d` integer - `countAllTime` integer - `document` AttributeVelocityCounts - `count1h` integer - `count24h` integer - `count7d` integer - `countAllTime` integer - `knownFace` AttributeVelocityCounts - `count1h` integer - `count24h` integer - `count7d` integer - `countAllTime` integer - `ipAddress` AttributeVelocityCounts - `count1h` integer - `count24h` integer - `count7d` integer - `countAllTime` integer - `address` AttributeVelocityCounts - `count1h` integer - `count24h` integer - `count7d` integer - `countAllTime` integer - `alerts` NetworkInsightAlert[]: Assembly-time snapshot of derived alerts evaluated from the bounded network insight evidence slice. Reader contracts default this field to an empty list when no non-default derived output is available, including required lookup failure cases. Alerts can remain present even if visible `networkInsight[]` rows later resolve to `missing` because of TTL masking. - `label` string - `drivers` string[] - `contributingTxnIds` string[] ## Other responses - `400`: Bad Request - `401`: Unauthorized - `404`: Not Found - `429`: Too Many Requests (rate limited) - `500`: Internal Server Error --- [API](https://skmtc.dev/trulioo/apis/kyc-document-api.md) - [All operations](https://skmtc.dev/trulioo/apis/kyc-document-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trulioo/apis/kyc-document-api/revisions/53a65736c9f8?raw)