Skip to main content
Get multiple audio classifications results
curl --request GET \
  --url https://backend.identifai.net/api/classifications_audio \
  --header 'X-Api-Key: <api-key>'
[
  {
    "hash": "<string>",
    "identifier": "<string>",
    "api_version": "<string>",
    "status": "new",
    "errors": "<string>",
    "name": "<string>",
    "ref_id": "<string>",
    "result_url": "<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": {}
      }
    ],
    "details": {
      "clips": [
        {
          "index": 123,
          "start": 123,
          "end": 123,
          "results": [
            {
              "model": "<string>",
              "unknown": true,
              "elapsed_time": 123,
              "classification": [
                {
                  "label": "human",
                  "score": 123
                }
              ],
              "classification_details": {}
            }
          ],
          "verdict": {
            "heuristic": "<string>",
            "confidence": 123,
            "classification": "human",
            "models": [
              "<string>"
            ]
          }
        }
      ]
    }
  }
]

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 audio classifications.

​
hash
string

SHA-256 hash of the classified audio file

​
identifier
string

The identifier that identifies the classified audio

​
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 audio file

​
ref_id
string

An optional reference ID to associate with the classification request.

​
result_url
string<uri>

URL where the classification results can be found on the dashboard

​
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

​
details
object

Per-segment details of the audio analysis, with each entry representing a clip extracted from the submitted audio