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

# Start verification for the current transaction

Starts the verification process and returns the status.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "KYC Document API",
    "version": "3.0",
    "termsOfService": "https://www.trulioo.com/legal/SST",
    "description": "The KYC Document API is organized around REST with predictable resource-oriented URLs, standard HTTP response codes, authentication, and verbs. It provides endpoints for transaction creation, document upload, verification, and retrieval of results.\n\n> Biometric notice (e.g., BIPA): Some US states regulate the collection and use of biometric identifiers and information, including facial scan data extracted from photos used in document verification. Customers must implement a notice and consent mechanism and confirm via API that the individual has consented as prescribed. Consult legal counsel for compliance.\n\n>\n> For service-specific terms, see: https://www.trulioo.com/legal/SST\n"
  },
  "servers": [
    {
      "url": "https://verification.trulioo.com"
    }
  ],
  "tags": [
    {
      "name": "Transaction",
      "description": "Create transactions, upload documents, verify, and fetch results."
    }
  ],
  "security": [
    {
      "AccessToken": []
    }
  ],
  "paths": {
    "/api/transactions/verify": {
      "post": {
        "tags": [
          "Transaction"
        ],
        "summary": "Start verification for the current transaction",
        "operationId": "verifyTransaction",
        "description": "Starts the verification process and returns the status.",
        "parameters": [
          {
            "$ref": "#/components/parameters/AcceptVersion"
          }
        ],
        "responses": {
          "200": {
            "description": "Decision available.",
            "headers": {
              "Accept-Version": {
                "$ref": "#/components/headers/AcceptVersion"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DecisionResponse"
                }
              }
            }
          },
          "202": {
            "description": "Verification in progress.",
            "headers": {
              "Accept-Version": {
                "$ref": "#/components/headers/AcceptVersion"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "PENDING_RESULT"
                      ],
                      "example": "PENDING_RESULT"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableEntity"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "AccessToken": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Access token (Bearer) required for most endpoints."
      }
    },
    "parameters": {
      "AcceptVersion": {
        "name": "Accept-Version",
        "in": "header",
        "required": true,
        "schema": {
          "type": "string",
          "example": "3.0"
        },
        "description": "API version header."
      }
    },
    "headers": {
      "AcceptVersion": {
        "description": "API Version of the response.",
        "schema": {
          "type": "string",
          "example": "3.0"
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad Request",
        "headers": {
          "Accept-Version": {
            "$ref": "#/components/headers/AcceptVersion"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Unauthorized",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "x-examples": {
          "default": {
            "code": "JWT_EXPIRED",
            "message": "Jwt is expired"
          }
        }
      },
      "Forbidden": {
        "description": "Forbidden",
        "headers": {
          "Accept-Version": {
            "$ref": "#/components/headers/AcceptVersion"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "x-examples": {
          "default": {
            "code": "ACCESS_DENIED",
            "message": "Access Denied"
          }
        }
      },
      "NotFound": {
        "description": "Not Found",
        "headers": {
          "Accept-Version": {
            "$ref": "#/components/headers/AcceptVersion"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "x-examples": {
          "default": {
            "code": "NOT_FOUND",
            "message": "Check if the transactionId is correct."
          }
        }
      },
      "UnprocessableEntity": {
        "description": "Unprocessable Entity",
        "headers": {
          "Accept-Version": {
            "$ref": "#/components/headers/AcceptVersion"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "x-examples": {
          "frontImageMissing": {
            "code": "FRONT_IMAGE_MISSING",
            "message": "Front image missing. Make sure the front image is available."
          },
          "backImageMissing": {
            "code": "BACK_IMAGE_MISSING",
            "message": "Back image missing. Make sure the back image is available."
          },
          "faceImageMissing": {
            "code": "FACE_IMAGE_MISSING",
            "message": "Face image missing. Make sure the selfie image is available."
          },
          "documentNotFullyInFrame": {
            "code": "DOCUMENT_NOT_FULLY_IN_FRAME",
            "message": "Document not fully in frame."
          },
          "faceNotFullyInFrame": {
            "code": "FACE_NOT_FULLY_IN_FRAME",
            "message": "Face not fully in frame."
          }
        }
      },
      "TooManyRequests": {
        "description": "Too Many Requests (rate limited)",
        "headers": {
          "Retry-After": {
            "description": "Seconds until the client may retry.",
            "schema": {
              "type": "integer"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "x-examples": {
          "default": {
            "code": "RATE_LIMITED",
            "message": "Too many requests. Please retry later."
          }
        }
      },
      "InternalError": {
        "description": "Internal Server Error",
        "headers": {
          "Accept-Version": {
            "$ref": "#/components/headers/AcceptVersion"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "x-examples": {
          "default": {
            "code": "INTERNAL_ERROR",
            "message": "The server encountered an error. Please email us at support@trulioo.com."
          }
        }
      },
      "ServiceUnavailable": {
        "description": "Service Unavailable",
        "headers": {
          "Accept-Version": {
            "$ref": "#/components/headers/AcceptVersion"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "x-examples": {
          "default": {
            "code": "SERVICE_UNAVAILABLE",
            "message": "Service is currently not available. Please try again."
          }
        }
      }
    },
    "schemas": {
      "DecisionResponse": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "ACCEPTED",
              "REVIEW",
              "DECLINED",
              "ERROR",
              "NO_RESULT",
              "PENDING_RESULT"
            ],
            "description": "Final decision of the verification."
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "properties": {
          "code": {
            "type": "string",
            "example": "FACE_IMAGE_MISSING"
          },
          "message": {
            "type": "string",
            "example": "Face image missing. Make sure the selfie image is available."
          },
          "details": {
            "type": "object",
            "additionalProperties": true,
            "description": "Optional structured details for debugging or client handling."
          }
        }
      }
    }
  }
}
```