> ## Documentation Index
> Fetch the complete documentation index at: https://docs.identifai.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Envía tickets para su análisis

> Envía un lote de imágenes de tickets para la detección de **manipulaciones**. Cada ticket puede tener un ID externo, que se devuelve en la respuesta para facilitar su seguimiento.



## OpenAPI

````yaml es/api-v2/api-swagger-v2.json POST /api/v2/tampering/tickets
openapi: 3.0.0
info:
  title: API v2 de identifAI
  version: 2.0.0
  description: >-
    API v2 para la detección de manipulaciones por lotes en imágenes de tickets.
    Esta API permite enviar varios tickets para su análisis y obtener los
    resultados de la detección de manipulaciones.
servers:
  - url: https://api.identifai.net
security: []
tags:
  - name: Tampering Detection
    description: Endpoints de detección de manipulaciones por lotes
paths:
  /api/v2/tampering/tickets:
    post:
      tags:
        - Tampering Detection
      summary: Envía tickets para su análisis
      description: >-
        Envía un lote de imágenes de tickets para la detección de
        **manipulaciones**. Cada ticket puede tener un ID externo, que se
        devuelve en la respuesta para facilitar su seguimiento.
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                tickets:
                  type: array
                  items:
                    type: string
                    format: binary
                  description: >-
                    Array de los archivos de los tickets (imágenes o PDF) que se
                    van a analizar
                ref_ids:
                  type: string
                  description: >-
                    Cadena con una lista de ref_id separados por comas. Si se
                    indica, el número de elementos debe coincidir con la
                    longitud del array de tickets.
                  example: Ticket-1, Ticket-2, Ticket-3
                models:
                  type: string
                  description: >-
                    Cadena opcional con los nombres de los modelos, separados
                    por comas, que se usarán para la detección de
                    manipulaciones. Si no se indica, se usan todos los modelos
                    disponibles para tu plan. Si está vacía, no se realiza
                    ninguna clasificación.
                  example: Model-1, Model-2, Model-3
              required:
                - tickets
      responses:
        '200':
          description: >-
            Envío del lote correcto. Devuelve la lista de los identificadores de
            los análisis.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchSubmissionResponse'
              example:
                batch_id: 674a3c9b8e2d4f12b7c9a8d3
                total_tickets: 3
                submissions:
                  - identifier: 674a3c9b8e2d4f12b7c9a8d4
                    ref_id: Ticket-001
                  - identifier: 674a3c9b8e2d4f12b7c9a8d5
                    ref_id: Ticket-002
                  - identifier: 674a3c9b8e2d4f12b7c9a8d6
                    ref_id: Ticket-003
        '400':
          description: Solicitud incorrecta - Parámetros de entrada no válidos
          content:
            application/json:
              example:
                error: Invalid request
                message: The number of ref_ids must match the number of tickets
        '401':
          description: API key no válida o ausente
          content:
            application/json:
              example:
                error: Unauthorized
                message: Invalid or missing API key
        '413':
          description: Payload demasiado grande - El tamaño del lote supera el límite
          content:
            application/json:
              example:
                error: Payload too large
                message: Maximum batch size is 10 tickets
      security:
        - ApiKeyAuth: []
components:
  schemas:
    BatchSubmissionResponse:
      type: object
      properties:
        batch_id:
          type: string
          description: Identificador único de este envío por lotes
        total_tickets:
          type: integer
          description: Número total de tickets enviados en este lote
        submissions:
          type: array
          description: >-
            Lista de los identificadores de los envíos de imágenes creados. La
            lista puede ser más larga que el número de tickets si de un mismo
            ticket se han extraído varias imágenes (p. ej., un archivo PDF). En
            este caso, varios envíos hacen referencia al mismo ref_id.
          items:
            $ref: '#/components/schemas/AnalysisIdentifier'
    AnalysisIdentifier:
      type: object
      properties:
        identifier:
          type: string
          description: Identificador interno del análisis
        ref_id:
          type: string
          description: ID de referencia indicado en el envío (si existe)
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.