Skip to main content
GET
/
api
/
classification
/
{identifier}
Get single image classification result
curl --request GET \
  --url https://backend.identifai.net/api/classification/{identifier} \
  --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.

Path Parameters

identifier
string
required

The identifier of the image.

Response

The classification result.

The answer for image classification

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