Skip to main content
Submit tickets for analysis
curl --request POST \
  --url https://api.identifai.net/api/v2/tampering/tickets \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <api-key>' \
  --form 'tickets=<string>' \
  --form 'ref_ids=Ticket-1, Ticket-2, Ticket-3' \
  --form 'models=Model-1, Model-2, Model-3' \
  --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

String containing a list of comma-separated ref_ids. The number of items must match the length of tickets array if provided.

Example:

"Ticket-1, Ticket-2, Ticket-3"

ā€‹
models
string

Optional string of comma-separated 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.

Example:

"Model-1, Model-2, Model-3"

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.