> ## 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.

# Obtén los resultados del análisis de tickets

> Obtiene los resultados de la detección de manipulaciones del lote indicado.



## OpenAPI

````yaml es/api-v2/api-swagger-v2.json GET /api/v2/tampering/tickets/{batch_id}
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/{batch_id}:
    get:
      tags:
        - Tampering Detection
      summary: Obtén los resultados del análisis de tickets
      description: >-
        Obtiene los resultados de la detección de manipulaciones del lote
        indicado.
      parameters:
        - name: batch_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            El identificador del lote cuyos resultados del análisis de
            manipulación se quieren obtener
      responses:
        '200':
          description: Resultados del análisis obtenidos correctamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchResultsResponse'
              example:
                identifier: 674a3c9b8e2d4f12b7c9a8d3
                done: false
                total_results: 2
                results:
                  - identifier: 674a3c9b8e2d4f12b7c9a8d4
                    ref_id: TICKET-001
                    status: done
                    hash: >-
                      862bb7de43b131a38b64753269d643443a21069a04ab66a56c9818956f590cb9
                    name: ticket_001.jpg
                    verdict:
                      confidence: 1
                      classification: tampered
                    verdicts:
                      - heuristic: heuristic_name_1
                        description: Human readable description of the heuristic_name_1
                        classification: tampered
                      - heuristic: heuristic_name_2
                        description: Human readable description of the heuristic_name_2
                        classification: tampered
                      - heuristic: heuristic_name_3
                        description: Human readable description of the heuristic_name_3
                        classification: tampered
                      - heuristic: heuristic_name_4
                        description: Human readable description of the heuristic_name_4
                        classification: authentic
                    results:
                      - model: Ellen
                        unknown: false
                        elapsed_time: 0.1473182961344719
                        classification:
                          - label: human
                            score: 0.15
                          - label: artificial
                            score: 0.85
                        classification_details:
                          confidence: 0.85
                          performance:
                            - name: classification
                              value: 0.1473182961344719
                    c2pa: null
                  - identifier: 674a3c9b8e2d4f12b7c9a8d5
                    ref_id: TICKET-002
                    status: inprogress
        '400':
          description: Solicitud incorrecta - Identificadores no válidos
          content:
            application/json:
              example:
                error: Invalid request
                message: identifiers array cannot be empty
        '401':
          description: API key no válida o ausente
          content:
            application/json:
              example:
                error: Unauthorized
                message: Invalid or missing API key
        '404':
          description: No se han encontrado uno o varios identificadores
          content:
            application/json:
              example:
                error: Not found
                message: Batch not found
                batch_id: 674a3c9b8e2d4f12b7c9a8d9
      security:
        - ApiKeyAuth: []
components:
  schemas:
    BatchResultsResponse:
      type: object
      properties:
        identifier:
          type: string
          description: Identificador del lote de este análisis
        done:
          type: boolean
          description: Indica si todos los análisis del lote se han completado
        total_results:
          type: integer
          description: Número total de resultados devueltos
        results:
          type: array
          description: Array de los resultados del análisis de manipulación
          items:
            $ref: '#/components/schemas/TamperingResult'
    TamperingResult:
      type: object
      properties:
        identifier:
          type: string
          description: Identificador interno del análisis
        ref_id:
          type: string
          description: ID de referencia asociado a este ticket
        status:
          type: string
          enum:
            - new
            - inprogress
            - done
            - errored
          description: Estado actual del análisis
        hash:
          type: string
          description: Hash SHA-256 de la imagen (solo si se ha completado)
        name:
          type: string
          description: Nombre del archivo original del ticket (solo si se ha completado)
        verdict:
          $ref: '#/components/schemas/OverallTamperingVerdict'
          description: >-
            Veredicto principal de la detección de manipulaciones (solo si se ha
            completado)
        verdicts:
          type: array
          description: >-
            Todos los veredictos de las distintas heurísticas (solo si se ha
            completado)
          items:
            $ref: '#/components/schemas/TamperingVerdict'
        results:
          type: array
          description: Resultados detallados de cada modelo (solo si se ha completado)
          items:
            $ref: '#/components/schemas/ModelResult'
        c2pa:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/C2PA'
          description: >-
            Información de la Coalition for Content Provenance and Authenticity
            que certifica el origen y el historial del contenido multimedia.
            Contiene los manifiestos, los resultados de la validación y la
            información de la firma. Null si la imagen no contiene metadatos
            C2PA.
      required:
        - identifier
        - status
    OverallTamperingVerdict:
      type: object
      properties:
        confidence:
          type: number
          format: float
          description: Puntuación de confianza entre 0 y 1
        classification:
          type: string
          enum:
            - authentic
            - tampered
          description: 'Resultado de la clasificación: authentic o tampered'
    TamperingVerdict:
      type: object
      properties:
        heuristic:
          type: string
          description: Nombre de la heurística o del algoritmo usado
        description:
          type: string
          description: Descripción de la heurística o del algoritmo
        classification:
          type: string
          enum:
            - authentic
            - tampered
          description: 'Resultado de la clasificación: authentic o tampered'
    ModelResult:
      type: object
      properties:
        model:
          type: string
          description: Nombre del modelo usado
        unknown:
          type: boolean
          description: Indica si el resultado es incierto
        elapsed_time:
          type: number
          format: float
          description: Tiempo empleado en la clasificación, en segundos
        classification:
          type: array
          description: Puntuaciones de clasificación de cada etiqueta
          items:
            $ref: '#/components/schemas/ClassificationScore'
        classification_details:
          type: object
          description: Detalles adicionales de la clasificación
          properties:
            confidence:
              type: number
              format: float
            performance:
              type: array
              items:
                type: object
                properties:
                  name:
                    type: string
                  value:
                    type: number
    C2PA:
      type: object
      properties:
        manifests:
          type: object
          description: >-
            Diccionario de los manifiestos C2PA, indexados por el URN del
            manifiesto. Cada manifiesto contiene información sobre el historial
            de creación y modificación del contenido.
          additionalProperties:
            type: object
            properties:
              label:
                type: string
                description: Identificador URN de este manifiesto
              title:
                type: string
                description: Título legible del manifiesto
              assertions:
                type: array
                description: Lista de las aserciones criptográficas sobre el contenido
                items:
                  type: object
                  properties:
                    label:
                      type: string
                      description: Tipo de aserción (p. ej., 'c2pa.actions.v2')
                    data:
                      type: object
                      description: Contenido de los datos de la aserción
              ingredients:
                type: array
                description: >-
                  Lista de los materiales de origen usados para crear este
                  contenido
                items:
                  type: object
                  properties:
                    label:
                      type: string
                      description: Tipo de ingrediente
                    title:
                      type: string
                      description: Nombre del ingrediente
                    format:
                      type: string
                      description: Formato de archivo del ingrediente
                    relationship:
                      type: string
                      description: Relación con el contenido padre (p. ej., 'componentOf')
                    active_manifest:
                      type: string
                      description: URN del manifiesto activo del ingrediente
                    validation_results:
                      type: object
                      description: Resultados de la validación de este ingrediente
              instance_id:
                type: string
                description: ID de instancia XMP
              signature_info:
                type: object
                description: Información sobre la firma criptográfica
                properties:
                  alg:
                    type: string
                    description: Algoritmo de firma usado (p. ej., 'Es256')
                  issuer:
                    type: string
                    description: Emisor del certificado
                  common_name:
                    type: string
                    description: Common name del certificado
                  cert_serial_number:
                    type: string
                    description: Número de serie del certificado
              claim_generator_info:
                type: array
                description: Información sobre el software que generó la claim
                items:
                  type: object
                  properties:
                    name:
                      type: string
                      description: Nombre del software generador de la claim
        active_manifest:
          type: string
          description: URN del manifiesto activo actualmente
        validation_state:
          type: string
          enum:
            - Valid
            - Invalid
            - Unknown
          description: Estado general de la validación de los datos C2PA
        validation_status:
          type: array
          description: Lista de los mensajes de estado de la validación
          items:
            type: object
            properties:
              url:
                type: string
                description: URN o URL del elemento validado
              code:
                type: string
                description: Código de estado de la validación
              explanation:
                type: string
                description: Explicación legible del resultado de la validación
        validation_results:
          type: object
          description: Resultados detallados de la validación
          properties:
            activeManifest:
              type: object
              properties:
                failure:
                  type: array
                  description: Lista de las validaciones fallidas
                  items:
                    type: object
                success:
                  type: array
                  description: Lista de las validaciones correctas
                  items:
                    type: object
                informational:
                  type: array
                  description: Mensajes informativos de la validación
                  items:
                    type: object
            ingredientDeltas:
              type: array
              description: Diferencias de validación de los ingredientes
              items:
                type: object
    ClassificationScore:
      type: object
      properties:
        label:
          type: string
          description: Etiqueta de clasificación
        score:
          type: number
          format: float
          description: Puntuación de esta etiqueta entre 0 y 1
  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.