Get tickets analysis results

curl --request GET \
  --url https://backend.identifai.net/api/v2/tampering/tickets/{batch_id} \
  --header 'X-Api-Key: <api-key>'

{
  "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"
    }
  ]
}

GET

api

tampering

tickets

{batch_id}

Get tickets analysis results

curl --request GET \
  --url https://backend.identifai.net/api/v2/tampering/tickets/{batch_id} \
  --header 'X-Api-Key: <api-key>'

{
  "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"
    }
  ]
}

Authorizations

X-Api-Key

string

header

required

Path Parameters

batch_id

string

required

The batch identifier for which to retrieve tampering analysis results

Response

Analysis results retrieved successfully

identifier

string

Batch identifier for this analysis

done

boolean

Indicates if all analyses in the batch are completed

total_results

integer

Total number of results returned

results

object[]

Array of tampering analysis results

Show child attributes

results.identifier

string

required

Internal analysis identifier

results.status

enum<string>

required

Current status of the analysis

Available options:

new,

inprogress,

done,

errored

results.ref_id

string

Reference ID associated with this ticket

results.hash

string

SHA-256 hash of the image (only if completed)

results.name

string

Original filename of the ticket (only if completed)

results.verdict

object

Primary verdict for tampering detection (only if completed)

Show child attributes

results.verdict.confidence

number<float>

Confidence score between 0 and 1

results.verdict.classification

enum<string>

Classification result: authentic, or tampered

Available options:

authentic,

tampered

results.verdicts

object[]

All verdicts from different heuristics (only if completed)

Show child attributes

results.verdicts.heuristic

string

Name of the heuristic/algorithm used

results.verdicts.description

string

Description of the heuristic/algorithm

results.verdicts.classification

enum<string>

Classification result: authentic or tampered

Available options:

authentic,

tampered

results.results

object[]

Detailed results from each model (only if completed)

Show child attributes

results.results.model

string

Name of the model used

results.results.unknown

boolean

Whether the result is uncertain

results.results.elapsed_time

number<float>

Time taken for classification in seconds

results.results.classification

object[]

Classification scores for each label

Show child attributes

results.results.classification.label

string

Classification label

results.results.classification.score

number<float>

Score for this label between 0 and 1

results.results.classification_details

object

Additional classification details

Show child attributes

results.results.classification_details.confidence

number<float>

results.results.classification_details.performance

object[]

Show child attributes

results.results.classification_details.performance.name

string

results.results.classification_details.performance.value

number

results.c2pa

object

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.

Show child attributes

results.c2pa.manifests

object

Dictionary of C2PA manifests, keyed by manifest URN. Each manifest contains information about the content's creation and modification history.

Show child attributes

results.c2pa.manifests.{key}

object

Show child attributes

results.c2pa.manifests.{key}.label

string

URN identifier for this manifest

results.c2pa.manifests.{key}.title

string

Human-readable title of the manifest

results.c2pa.manifests.{key}.assertions

object[]

List of cryptographic assertions about the content

Show child attributes

results.c2pa.manifests.{key}.assertions.label

string

Type of assertion (e.g., 'c2pa.actions.v2')

results.c2pa.manifests.{key}.assertions.data

object

Assertion data content

results.c2pa.manifests.{key}.ingredients

object[]

List of source materials used to create this content

Show child attributes

results.c2pa.manifests.{key}.ingredients.label

string

Type of ingredient

results.c2pa.manifests.{key}.ingredients.title

string

Name of the ingredient

results.c2pa.manifests.{key}.ingredients.format

string

File format of the ingredient

results.c2pa.manifests.{key}.ingredients.relationship

string

Relationship to the parent content (e.g., 'componentOf')

results.c2pa.manifests.{key}.ingredients.active_manifest

string

URN of the ingredient's active manifest

results.c2pa.manifests.{key}.ingredients.validation_results

object

Validation results for this ingredient

results.c2pa.manifests.{key}.instance_id

string

XMP instance ID

results.c2pa.manifests.{key}.signature_info

object

Information about the cryptographic signature

Show child attributes

results.c2pa.manifests.{key}.signature_info.alg

string

Signature algorithm used (e.g., 'Es256')

results.c2pa.manifests.{key}.signature_info.issuer

string

Certificate issuer

results.c2pa.manifests.{key}.signature_info.common_name

string

Common name from the certificate

results.c2pa.manifests.{key}.signature_info.cert_serial_number

string

Certificate serial number

results.c2pa.manifests.{key}.claim_generator_info

object[]

Information about the software that generated the claim

Show child attributes

results.c2pa.manifests.{key}.claim_generator_info.name

string

Name of the claim generator software

results.c2pa.active_manifest

string

URN of the currently active manifest

results.c2pa.validation_state

enum<string>

Overall validation state of the C2PA data

Available options:

Valid,

Invalid,

Unknown

results.c2pa.validation_status

object[]

List of validation status messages

Show child attributes

results.c2pa.validation_status.url

string

URN or URL of the validated element

results.c2pa.validation_status.code

string

Validation status code

results.c2pa.validation_status.explanation

string

Human-readable explanation of the validation result

results.c2pa.validation_results

object

Detailed validation results

Show child attributes

results.c2pa.validation_results.activeManifest

object

Show child attributes

results.c2pa.validation_results.activeManifest.failure

object[]

List of validation failures

results.c2pa.validation_results.activeManifest.success

object[]

List of successful validations

results.c2pa.validation_results.activeManifest.informational

object[]

Informational validation messages

results.c2pa.validation_results.ingredientDeltas

object[]

Validation deltas for ingredients

Submit tickets for analysis

⌘I

API v2 Documentation

Tampering Detection

Get tickets analysis results

Authorizations

Path Parameters

Response