Skip to main content
Get multiple video classifications results
curl --request GET \
  --url https://backend.identifai.net/api/classifications_video \
  --header 'X-Api-Key: <api-key>'
[
  {
    "hash": "<string>",
    "identifier": "<string>",
    "api_version": "<string>",
    "status": "new",
    "errors": "<string>",
    "name": "<string>",
    "ref_id": "<string>",
    "verdict": {
      "heuristic": "<string>",
      "confidence": 123,
      "classification": "human",
      "count": 123,
      "models": [
        "<string>"
      ],
      "unknown": true
    },
    "verdicts": [
      {
        "heuristic": "<string>",
        "confidence": 123,
        "classification": "human",
        "count": 123,
        "models": [
          "<string>"
        ],
        "unknown": true
      }
    ],
    "force_classification": "human",
    "results": {
      "images": [
        {
          "hash": "<string>",
          "identifier": "<string>",
          "api_version": "<string>",
          "status": "new",
          "errors": "<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": {}
            }
          ]
        }
      ],
      "audios": [
        {
          "hash": "<string>",
          "identifier": "<string>",
          "api_version": "<string>",
          "status": "new",
          "errors": "<string>",
          "name": "<string>",
          "ref_id": "<string>",
          "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 video classifications.

​
hash
string

SHA-256 hash of the classified video file

​
identifier
string

The identifier that identifies the classified video

​
api_version
string | null

The API version at the time of the analysis (available from v1.1.0). The value is set when the analysis completes.

​
status
enum<string>

The processing status of the classification request (available from v1.1.0)

Available options:
new,
done,
errored
​
errors
string | null

Error messages if the status is 'errored' (available from v1.1.0)

​
name
string

The name of the classified video file

​
ref_id
string

An optional reference ID to associate with the classification request.

​
verdict
object

The main classification verdict for the entire video using the user's default heuristic

​
verdicts
object[]

Array of verdicts for all available heuristics applied to the entire video

​
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 results containing analyzed frames from the video