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

# Get tickets analysis results

> Retrieve the tampering detection results for the given batch.



## OpenAPI

````yaml get /api/v2/tampering/tickets/{batch_id}
openapi: 3.0.0
info:
  title: IdentifAI API v2
  version: 2.0.0
  description: >-
    API v2 for batch tampering detection on ticket images. This API allows you
    to submit multiple tickets for analysis and retrieve results for tampering
    detection.
servers:
  - url: https://api.identifai.net
security: []
tags:
  - name: Tampering Detection
    description: Batch tampering detection endpoints
paths:
  /api/v2/tampering/tickets/{batch_id}:
    get:
      tags:
        - Tampering Detection
      summary: Get tickets analysis results
      description: Retrieve the tampering detection results for the given batch.
      parameters:
        - name: batch_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            The batch identifier for which to retrieve tampering analysis
            results
      responses:
        '200':
          description: Analysis results retrieved successfully
          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: Bad request - Invalid identifiers
          content:
            application/json:
              example:
                error: Invalid request
                message: identifiers array cannot be empty
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              example:
                error: Unauthorized
                message: Invalid or missing API key
        '404':
          description: One or more identifiers not found
          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: Batch identifier for this analysis
        done:
          type: boolean
          description: Indicates if all analyses in the batch are completed
        total_results:
          type: integer
          description: Total number of results returned
        results:
          type: array
          description: Array of tampering analysis results
          items:
            $ref: '#/components/schemas/TamperingResult'
    TamperingResult:
      type: object
      properties:
        identifier:
          type: string
          description: Internal analysis identifier
        ref_id:
          type: string
          description: Reference ID associated with this ticket
        status:
          type: string
          enum:
            - new
            - inprogress
            - done
            - errored
          description: Current status of the analysis
        hash:
          type: string
          description: SHA-256 hash of the image (only if completed)
        name:
          type: string
          description: Original filename of the ticket (only if completed)
        verdict:
          $ref: '#/components/schemas/OverallTamperingVerdict'
          description: Primary verdict for tampering detection (only if completed)
        verdicts:
          type: array
          description: All verdicts from different heuristics (only if completed)
          items:
            $ref: '#/components/schemas/TamperingVerdict'
        results:
          type: array
          description: Detailed results from each model (only if completed)
          items:
            $ref: '#/components/schemas/ModelResult'
        c2pa:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/C2PA'
          description: >-
            Coalition for Content Provenance and Authenticity information that
            certifies the source and history of media content. Contains
            manifests, validation results, and signature information. Null if
            the image doesn't contain C2PA metadata.
      required:
        - identifier
        - status
    OverallTamperingVerdict:
      type: object
      properties:
        confidence:
          type: number
          format: float
          description: Confidence score between 0 and 1
        classification:
          type: string
          enum:
            - authentic
            - tampered
          description: 'Classification result: authentic, or tampered'
    TamperingVerdict:
      type: object
      properties:
        heuristic:
          type: string
          description: Name of the heuristic/algorithm used
        description:
          type: string
          description: Description of the heuristic/algorithm
        classification:
          type: string
          enum:
            - authentic
            - tampered
          description: 'Classification result: authentic or tampered'
    ModelResult:
      type: object
      properties:
        model:
          type: string
          description: Name of the model used
        unknown:
          type: boolean
          description: Whether the result is uncertain
        elapsed_time:
          type: number
          format: float
          description: Time taken for classification in seconds
        classification:
          type: array
          description: Classification scores for each label
          items:
            $ref: '#/components/schemas/ClassificationScore'
        classification_details:
          type: object
          description: Additional classification details
          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: >-
            Dictionary of C2PA manifests, keyed by manifest URN. Each manifest
            contains information about the content's creation and modification
            history.
          additionalProperties:
            type: object
            properties:
              label:
                type: string
                description: URN identifier for this manifest
              title:
                type: string
                description: Human-readable title of the manifest
              assertions:
                type: array
                description: List of cryptographic assertions about the content
                items:
                  type: object
                  properties:
                    label:
                      type: string
                      description: Type of assertion (e.g., 'c2pa.actions.v2')
                    data:
                      type: object
                      description: Assertion data content
              ingredients:
                type: array
                description: List of source materials used to create this content
                items:
                  type: object
                  properties:
                    label:
                      type: string
                      description: Type of ingredient
                    title:
                      type: string
                      description: Name of the ingredient
                    format:
                      type: string
                      description: File format of the ingredient
                    relationship:
                      type: string
                      description: Relationship to the parent content (e.g., 'componentOf')
                    active_manifest:
                      type: string
                      description: URN of the ingredient's active manifest
                    validation_results:
                      type: object
                      description: Validation results for this ingredient
              instance_id:
                type: string
                description: XMP instance ID
              signature_info:
                type: object
                description: Information about the cryptographic signature
                properties:
                  alg:
                    type: string
                    description: Signature algorithm used (e.g., 'Es256')
                  issuer:
                    type: string
                    description: Certificate issuer
                  common_name:
                    type: string
                    description: Common name from the certificate
                  cert_serial_number:
                    type: string
                    description: Certificate serial number
              claim_generator_info:
                type: array
                description: Information about the software that generated the claim
                items:
                  type: object
                  properties:
                    name:
                      type: string
                      description: Name of the claim generator software
        active_manifest:
          type: string
          description: URN of the currently active manifest
        validation_state:
          type: string
          enum:
            - Valid
            - Invalid
            - Unknown
          description: Overall validation state of the C2PA data
        validation_status:
          type: array
          description: List of validation status messages
          items:
            type: object
            properties:
              url:
                type: string
                description: URN or URL of the validated element
              code:
                type: string
                description: Validation status code
              explanation:
                type: string
                description: Human-readable explanation of the validation result
        validation_results:
          type: object
          description: Detailed validation results
          properties:
            activeManifest:
              type: object
              properties:
                failure:
                  type: array
                  description: List of validation failures
                  items:
                    type: object
                success:
                  type: array
                  description: List of successful validations
                  items:
                    type: object
                informational:
                  type: array
                  description: Informational validation messages
                  items:
                    type: object
            ingredientDeltas:
              type: array
              description: Validation deltas for ingredients
              items:
                type: object
    ClassificationScore:
      type: object
      properties:
        label:
          type: string
          description: Classification label
        score:
          type: number
          format: float
          description: Score for this label between 0 and 1
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````