> ## Documentation Index > Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt > Use this file to discover all available pages before exploring further. # Starts processing of the files in new transaction > Creates a transaction that will be used to process some files. The maximum size of request body should not exceed 2 GB. The transaction will start automatically. For a step-by-step walkthrough of the single-call scenario, see [Processing documents with a single API call](/vantage/developer/processing-documents/processing-documents-single-api). New to the API? Start with the [Getting started guide](/vantage/developer/getting-started). ## OpenAPI ````yaml /openapi.json post /api/publicapi/v1/transactions/launch openapi: 3.0.1 info: title: Vantage processing REST API description: >- The Vantage Processing REST API lets you process documents programmatically: create transactions, upload files, launch skills, monitor progress, and download results. For authentication and a first end-to-end request, see the [Getting started guide](/vantage/developer/getting-started). version: '1.0' x-application-version: 1.0.0-20251028.13+6e102d0c2a7a440df9ee9615e09b3c8c333587ac servers: - url: https://vantage-us.abbyy.com description: Production United States - url: https://vantage-eu.abbyy.com description: Production Europe - url: https://vantage-au.abbyy.com description: Production Australia security: - OAuth2Security: - global.wildcard - openid - permissions paths: /api/publicapi/v1/transactions/launch: post: tags: - Transactions summary: Starts processing of the files in new transaction description: "Creates a transaction that will be used to process some files.\r\nThe maximum size of request body should not exceed 2 GB.\r\nThe transaction will start automatically." operationId: LaunchTransaction parameters: - name: skillId in: query schema: type: string description: >- Identifier of the skill to process the files with. You can find it in the list of all skills returned by `GET /api/publicapi/v1/skills`. requestBody: content: multipart/form-data: schema: type: object properties: Model: type: object properties: files: type: array items: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.TransactionFileMetadataDto description: Files processing parameters nullable: true registrationParameters: maxItems: 10 type: array items: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.TransactionRegistrationParameter description: Additional registration parameters for transaction nullable: true skillParameters: maxItems: 10 type: array items: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.TransactionSkillParameter description: Skill parameters for transaction nullable: true additionalProperties: false description: >- Additional transaction processing parameters. See TransactionLaunchMetadataDto model. Files: type: array items: type: string description: Model for getting file passed in multipart/* content format: binary encoding: Model: contentType: application/json style: form explode: true Files: contentType: application/octet-stream style: form explode: true responses: '201': description: Transaction successfully created and started content: text/plain: schema: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Results.CreatedTransactionResult application/json: schema: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Results.CreatedTransactionResult text/json: schema: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Results.CreatedTransactionResult '400': description: Some files are invalid or skillId is not specified content: text/plain: schema: $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails' application/json: schema: $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails' text/json: schema: $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails' '404': description: Skill with specified skillId not found or not published content: text/plain: schema: $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails' application/json: schema: $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails' text/json: schema: $ref: '#/components/schemas/Microsoft.AspNetCore.Mvc.ProblemDetails' components: schemas: Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.TransactionFileMetadataDto: type: object properties: index: type: integer description: Documents in transaction will be ordered by this parameter format: int32 nullable: true imageProcessingOptions: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.ImageProcessingOptions description: >- Image preprocessing settings (automatic cropping and orientation correction) applied to this file on import. registrationParameters: maxItems: 10 type: array items: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.TransactionFileRegistrationParameter description: "Additional file registration parameters. Predefined parameters:\r\n \r\nSourceType: Where the file came from, usually the connector name (scanning station);\r\n \r\nSourceDetails: How the file was received;\r\n \r\nSourceFileName: The name of the file being added (invoice.jfif)\r\n \r\nSourceFilePath: The path to the file\r\n \r\nSourceArchiveName: The name of the archive containing the file being added\r\n \r\nSourceFolderName: The name of the subfolder which containing the file being added" nullable: true additionalProperties: false description: Additional file processing parameters Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.TransactionRegistrationParameter: required: - key - value type: object properties: key: minLength: 1 type: string description: Key (name) of the parameter value: minLength: 1 type: string description: Value of the parameter additionalProperties: false description: Transaction registration parameter Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.TransactionSkillParameter: required: - key - value type: object properties: key: minLength: 1 type: string description: Key (name) of the parameter value: minLength: 1 type: string description: Value of the parameter additionalProperties: false description: Skill parameter for transaction Abbyy.Vantage.PublicApi.Contract.Transactions.Results.CreatedTransactionResult: required: - transactionId type: object properties: transactionId: type: string format: uuid description: >- Unique identifier of the created transaction. Use it in subsequent requests to add files, start processing, and download results. additionalProperties: false Microsoft.AspNetCore.Mvc.ProblemDetails: type: object properties: type: type: string nullable: true description: URI reference that identifies the problem type. title: type: string nullable: true description: Short, human-readable summary of the problem type. status: type: integer format: int32 nullable: true description: HTTP status code for this occurrence of the problem. detail: type: string nullable: true description: >- Human-readable explanation specific to this occurrence of the problem. instance: type: string nullable: true description: >- URI reference that identifies this specific occurrence of the problem. additionalProperties: {} Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.ImageProcessingOptions: type: object properties: autoCrop: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.PreprocessingOperationSwitcher description: >- Controls automatic cropping of images during import. Set to `Yes` or `No` to override the skill settings, or `Default` to use the behavior configured in the skill. autoOrientation: $ref: >- #/components/schemas/Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.PreprocessingOperationSwitcher description: >- Controls automatic page orientation correction during import. Set to `Yes` or `No` to override the skill settings, or `Default` to use the behavior configured in the skill. additionalProperties: false description: Image preprocessing settings for import Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.TransactionFileRegistrationParameter: required: - key - value type: object properties: key: minLength: 1 type: string description: Key (name) of the parameter value: minLength: 1 type: string description: Value of the parameter additionalProperties: false Abbyy.Vantage.PublicApi.Contract.Transactions.Requests.PreprocessingOperationSwitcher: enum: - Default - 'Yes' - 'No' type: string description: Switcher of image preprocessing operations securitySchemes: OAuth2Security: type: oauth2 flows: authorizationCode: authorizationUrl: https://vantage-us.abbyy.com/auth2/connect/authorize tokenUrl: https://vantage-us.abbyy.com/auth2/connect/token scopes: global.wildcard: Global wildcard openid: User Id permissions: User permissions ````