Skip to main content
POST
/
api
/
v2
/
tampering
/
tickets
Submit tickets for analysis
curl --request POST \
  --url https://backend.identifai.net/api/v2/tampering/tickets \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <api-key>' \
  --form 'tickets=<string>' \
  --form 'ref_ids=<string>' \
  --form models=Ellen \
  --form tickets.items='@example-file'
{
  "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"
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

Body

multipart/form-data
​
tickets
file[]
required

Array of ticket files (images or PDF) to analyze

​
ref_ids
string[]

Optional array of external reference IDs corresponding to each ticket. Must match the length of tickets array if provided.

​
models
enum<string>[]

Optional array of model names to use for tampering detection. If not given, all available models for your tier will be used. If empty, no classification will be performed.

Available options:
Ellen

Response

Batch submission successful. Returns the list of analysis identifiers.

​
batch_id
string

Unique identifier for this batch submission

​
total_tickets
integer

Total number of tickets submitted in this batch

​
submissions
object[]

List of image submission identifiers created. The list could be greater than the number of tickets if multiple images have been extracted from a single ticket (e.g. PDF file). In this case, multiple submission will refer to the same ref_id.