Skip to main content
Get multiple image classifications results
curl --request GET \
  --url https://backend.identifai.net/api/classifications \
  --header 'X-Api-Key: <api-key>'
[
  {
    "hash": "<string>",
    "identifier": "<string>",
    "name": "<string>",
    "ref_id": "<string>",
    "c2pa": {
      "manifests": {},
      "active_manifest": "<string>",
      "validation_state": "Valid",
      "validation_status": [
        {
          "url": "<string>",
          "code": "<string>",
          "explanation": "<string>"
        }
      ],
      "validation_results": {
        "activeManifest": {
          "failure": [
            {}
          ],
          "success": [
            {}
          ],
          "informational": [
            {}
          ]
        },
        "ingredientDeltas": [
          {}
        ]
      }
    },
    "has_heatmap": true,
    "verdict": {
      "heuristic": "<string>",
      "confidence": 123,
      "classification": "human",
      "models": [
        "<string>"
      ]
    },
    "verdicts": [
      {
        "heuristic": "<string>",
        "confidence": 123,
        "classification": "human",
        "models": [
          "<string>"
        ]
      }
    ],
    "force_classification": "human",
    "results": [
      {
        "model": "<string>",
        "unknown": true,
        "elapsed_time": 123,
        "classification": [
          {
            "label": "human",
            "score": 123
          }
        ],
        "classification_details": {}
      }
    ]
  }
]

Authorizations

​
X-Api-Key
string
header
required

Your API key.

Query Parameters

​
identifiers[]
string[]
required

A list of identifiers to retrieve classifications for.

Maximum array length: 100

Response

A list of classifications.

​
hash
string

SHA-256 hash of the classified image file

​
identifier
string

The identifier that identifies the classified image

​
name
string

The name of the classified image file

​
ref_id
string

An optional reference ID to associate with the classification request.

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

​
has_heatmap
boolean

If the image has an AI content heatmap. The heatmap png can be retrieved from the specific endpoint /api/classification/heatmap/{identifier}.

​
verdict
object

The main classification verdict using the user's default heuristic

​
verdicts
object[]

Array of verdicts for all available heuristics

​
force_classification
enum<string> | null

If present, indicates that the user has forced the classification to the specified value

Available options:
human,
artificial
​
results
object[]

Detailed classification results from each AI detection model