identifAI API

identifAI API as documented publicly: 14 operations. Contract generated from the documentation by API Evangelist (2026-11-12); not the provider's own document.

GitHub OpenAPI

Operations 14

GET /api/classification GET /api/classification #
POST /api/classification POST /api/classification #
GET /api/classification/heatmap/{identifier} GET /api/classification/heatmap/{identifier} #
GET /api/classification/{identifier} Tracking the deferred results #
GET /api/classification_audio/{identifier} Tracking the deferred results #
GET /api/classification_image/{identifier} Retrieve the classification result for a specific image. #
GET /api/classification_video/{identifier} Tracking the deferred results #
GET /api/classifications Get multiple image classifications results #
GET /api/classifications_audio GET /api/classifications_audio #
GET /api/classifications_image Get multiple image classifications results #
GET /api/classifications_video GET /api/classifications_video #
GET /api/health GET /api/health #
GET /api/image_fromurl GET /api/image_fromurl #
POST /api/image_fromurl POST /api/image_fromurl #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/identifai-net:identifai-net-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

identifai-net-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: identifAI API
  version: '2026-11-12'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-12: 14 operation(s) read from 11 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; identifAI has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 8
    documentation: 6
    pages-with-code: 8
    pages-read: 11
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-12'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.identifai.net/api-reference/deferred-results.md
  - https://docs.identifai.net/api-reference/infrastructure/health.md
  - https://docs.identifai.net/api-reference/classification/get-all-classifications.md
  - https://docs.identifai.net/api-reference/deferred-results
  - https://docs.identifai.net/api-reference/classification/get-all-classifications
  - https://docs.identifai.net/api-reference/classification/get-all-classifications-video
  - https://docs.identifai.net/api-reference/classification/get-all-classifications-audio
  - https://docs.identifai.net/api-reference/classification/submit-an-image-for-classification
  - https://docs.identifai.net/api-reference/classification/submit-image-from-url
  - https://docs.identifai.net/api-reference/classification/get-classification-result
  - https://docs.identifai.net/api-reference/classification/get-classification-heatmap
servers:
- url: https://backend.identifai.net
paths:
  /api/classification:
    get:
      operationId: get_api_classification
      tags:
      - Api
      summary: GET /api/classification
      x-source: https://docs.identifai.net/api-reference/classification/submit-an-image-for-classification
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl);\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n} package main\nimport (\n \"fmt\"\n \"strings\"\
          \n \"net/http\"\n \"io\"\n)\nfunc main() {\n url := \"https://backend.identifai.net/api/classification\"\n payload := strings.NewReader(\"\
          -----011000010111000001101001\\r\\nContent-Disposition: form-data; name=\\\"image\\\"; filename=\\\"example-file\\\"\\r\\nContent-Type:\
          \ image/png\\r\\n\\r\\n<string>\\r\\n-----0"
    post:
      operationId: post_api_classification
      tags:
      - Api
      summary: POST /api/classification
      x-source: https://docs.identifai.net/api-reference/classification/submit-an-image-for-classification
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl curl --request POST  --url https://backend.identifai.net/api/classification  --header ''Content-Type: multipart/form-data''  --header
          ''X-Api-Key: <api-key>''  --form ''image=@example-file;type=image/png''  --form ''ref_id=<string>''  --form with_morphing=true  --form
          with_tampering=true  --form with_heatmap=true  --form with_smart_analysis=true  --form ''webhook_url=<string>''  --form with_xai=true  -'
  /api/classification/heatmap/{identifier}:
    get:
      operationId: get_api_classification_heatmap_identifier
      tags:
      - Api
      summary: GET /api/classification/heatmap/{identifier}
      x-source: https://docs.identifai.net/api-reference/classification/get-classification-heatmap
      parameters:
      - name: identifier
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiClassificationHeatmapIdentifierResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl curl --request GET  --url https://backend.identifai.net/api/classification/heatmap/{identifier}  --header ''X-Api-Key:
          <api-key>'' import requests

          url = "https://backend.identifai.net/api/classification/heatmap/{identifier}"

          headers = {"X-Api-Key": "<api-key>"}

          response = requests.get(url, headers=headers)

          print(response.text) const options = {method: ''GET'', headers: {''X-Api-Key'': ''<api-key>''}}'
  /api/classification/{identifier}:
    get:
      operationId: get_api_classification_identifier
      tags:
      - Api
      summary: Tracking the deferred results
      x-source: https://docs.identifai.net/api-reference/deferred-results.md
      parameters:
      - name: identifier
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiClassificationIdentifierResponse'
      x-evidence:
        kind: documentation
  /api/classification_audio/{identifier}:
    get:
      operationId: get_api_classification_audio_identifier
      tags:
      - Api
      summary: Tracking the deferred results
      x-source: https://docs.identifai.net/api-reference/deferred-results.md
      parameters:
      - name: identifier
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiClassificationAudioIdentifierResponse'
      x-evidence:
        kind: documentation
  /api/classification_image/{identifier}:
    get:
      operationId: get_api_classification_image_identifier
      tags:
      - Api
      summary: Retrieve the classification result for a specific image.
      x-source: https://docs.identifai.net/api-reference/classification/get-classification-result
      parameters:
      - name: identifier
        in: path
        required: true
        schema:
          type: string
      - name: X-Api-Key
        in: header
        required: true
        schema:
          type: string
        description: Your API key.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/classification_video/{identifier}:
    get:
      operationId: get_api_classification_video_identifier
      tags:
      - Api
      summary: Tracking the deferred results
      x-source: https://docs.identifai.net/api-reference/deferred-results.md
      parameters:
      - name: identifier
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiClassificationVideoIdentifierResponse'
      x-evidence:
        kind: documentation
  /api/classifications:
    get:
      operationId: get_api_classifications
      tags:
      - Api
      summary: Get multiple image classifications results
      description: 'Retrieve multiple image classification results by providing a list of identifiers.


        **Note:** This endpoint also has an alias available at `/api/classifications_image`.'
      x-source: https://docs.identifai.net/api-reference/classification/get-all-classifications.md
      parameters:
      - name: identifiers
        in: query
        required: true
        schema:
          type: string
        description: A list of identifiers to retrieve classifications for.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiClassificationsResponse'
      x-evidence:
        kind: documentation
  /api/classifications_audio:
    get:
      operationId: get_api_classifications_audio
      tags:
      - Api
      summary: GET /api/classifications_audio
      x-source: https://docs.identifai.net/api-reference/classification/get-all-classifications-audio
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiClassificationsAudioResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl curl --request GET  --url https://backend.identifai.net/api/classifications_audio  --header ''X-Api-Key: <api-key>'' import
          requests

          url = "https://backend.identifai.net/api/classifications_audio"

          headers = {"X-Api-Key": "<api-key>"}

          response = requests.get(url, headers=headers)

          print(response.text) const options = {method: ''GET'', headers: {''X-Api-Key'': ''<api-key>''}};

          fetch(''https://backend.ide'
  /api/classifications_image:
    get:
      operationId: get_api_classifications_image
      tags:
      - Api
      summary: Get multiple image classifications results
      description: Alias for retrieving multiple image classification results.
      x-source: https://docs.identifai.net/api-reference/classification/get-all-classifications
      parameters:
      - name: identifiers
        in: query
        required: true
        schema:
          type: array
        description: 'A list of identifiers to retrieve classifications for. Maximum array length: 100'
      - name: X-Api-Key
        in: header
        required: true
        schema:
          type: string
        description: Your API key.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiClassificationsImageResponse'
      x-evidence:
        kind: documentation
  /api/classifications_video:
    get:
      operationId: get_api_classifications_video
      tags:
      - Api
      summary: GET /api/classifications_video
      x-source: https://docs.identifai.net/api-reference/classification/get-all-classifications-video
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiClassificationsVideoResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl curl --request GET  --url https://backend.identifai.net/api/classifications_video  --header ''X-Api-Key: <api-key>'' import
          requests

          url = "https://backend.identifai.net/api/classifications_video"

          headers = {"X-Api-Key": "<api-key>"}

          response = requests.get(url, headers=headers)

          print(response.text) const options = {method: ''GET'', headers: {''X-Api-Key'': ''<api-key>''}};

          fetch(''https://backend.ide'
  /api/health:
    get:
      operationId: get_api_health
      tags:
      - Api
      summary: GET /api/health
      x-source: https://docs.identifai.net/api-reference/infrastructure/health.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl --request GET  --url https://backend.identifai.net/api/health
  /api/image_fromurl:
    get:
      operationId: get_api_image_fromurl
      tags:
      - Api
      summary: GET /api/image_fromurl
      x-source: https://docs.identifai.net/api-reference/classification/submit-image-from-url
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl);\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n} package main\nimport (\n \"fmt\"\n \"strings\"\
          \n \"net/http\"\n \"io\"\n)\nfunc main() {\n url := \"https://backend.identifai.net/api/image_fromurl\"\n payload := strings.NewReader(\"\
          -----011000010111000001101001\\r\\nContent-Disposition: form-data; name=\\\"file_url\\\"\\r\\n\\r\\n<string>\\r\\n-----011000010111000001101001\\\
          r\\nContent-Disposition: form"
    post:
      operationId: post_api_image_fromurl
      tags:
      - Api
      summary: POST /api/image_fromurl
      x-source: https://docs.identifai.net/api-reference/classification/submit-image-from-url
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl curl --request POST  --url https://backend.identifai.net/api/image_fromurl  --header ''Content-Type: multipart/form-data''  --header
          ''X-Api-Key: <api-key>''  --form ''file_url=<string>''  --form ''ref_id=<string>''  --form with_morphing= true  --form with_tampering=
          true  --form with_heatmap= true  --form with_smart_analysis= true  --form ''webhook_url=<string>''  --form with_xai= true  --form with_ll'
components:
  schemas:
    GetApiClassificationHeatmapIdentifierResponse:
      type: object
      properties:
        method:
          type: string
        headers:
          type: object
          properties:
            X-Api-Key:
              type: string
    GetApiClassificationIdentifierResponse:
      type: object
      properties:
        deferred_status:
          type: string
          description: '`pending` (main analysis still running), `inprogress`, `done`, `errored` (at least one deferred step failed: the main
            results are still valid), `skipped` (the main analysis failed), `expired` (not completed in time)'
        deferred_progress:
          type: string
          description: '`{ "current_idx": 1, "total": 2 }`: deferred steps completed so far, out of the total'
        deferred_errors:
          type: string
          description: Public messages of the deferred steps that failed
    GetApiClassificationAudioIdentifierResponse:
      type: object
      properties:
        deferred_status:
          type: string
          description: '`pending` (main analysis still running), `inprogress`, `done`, `errored` (at least one deferred step failed: the main
            results are still valid), `skipped` (the main analysis failed), `expired` (not completed in time)'
        deferred_progress:
          type: string
          description: '`{ "current_idx": 1, "total": 2 }`: deferred steps completed so far, out of the total'
        deferred_errors:
          type: string
          description: Public messages of the deferred steps that failed
    GetApiClassificationVideoIdentifierResponse:
      type: object
      properties:
        deferred_status:
          type: string
          description: '`pending` (main analysis still running), `inprogress`, `done`, `errored` (at least one deferred step failed: the main
            results are still valid), `skipped` (the main analysis failed), `expired` (not completed in time)'
        deferred_progress:
          type: string
          description: '`{ "current_idx": 1, "total": 2 }`: deferred steps completed so far, out of the total'
        deferred_errors:
          type: string
          description: Public messages of the deferred steps that failed
    GetApiClassificationsResponse:
      type: object
      properties:
        '200':
          type: string
          description: A list of classifications.
        '400':
          type: string
          description: Missing identifiers or too many identifiers.
        '401':
          type: string
          description: Invalid or missing API key.
        '403':
          type: string
          description: The user is not authorized to access this API or did not accept the terms of service.
        '429':
          type: string
          description: Too many requests.
    GetApiClassificationsAudioResponse:
      type: object
      properties:
        method:
          type: string
        headers:
          type: object
          properties:
            X-Api-Key:
              type: string
    GetApiClassificationsImageResponse:
      type: object
      properties:
        hash:
          type: string
          description: SHA-256 hash of the classified image file
        identifier:
          type: string
          description: The identifier that identifies the classified image
        api_version:
          type: string
          description: The API version at the time of the analysis (available from v1.1.0). The value is set when the analysis completes.
        status:
          type: string
          description: 'The processing status of the classification request (available from v1.1.0). Options: new, done, errored'
        deferred_status:
          type: string
          description: 'Status of the deferred results. Options: pending, inprogress, done, errored, skipped, expired'
        deferred_progress:
          type: object
          description: Progress of the deferred results
        deferred_errors:
          type: array
          description: Public messages of the deferred steps that failed
        errors:
          type: string
          description: Error messages if the status is 'errored'
        name:
          type: string
          description: The name of the classified image file
        ref_id:
          type: string
          description: An optional reference ID to associate with the classification request
        result_url:
          type: string
          description: URL where the classification results can be found on the dashboard
        is_nsfw:
          type: boolean
          description: Indicates if NSFW content was detected
        c2pa:
          type: object
          description: Coalition for Content Provenance and Authenticity information
        has_heatmap:
          type: boolean
          description: If the image has an AI content heatmap
        verdict:
          type: object
          description: The main classification verdict using the user's default heuristic
        verdicts:
          type: array
          description: Array of verdicts for all available heuristics
        force_classification:
          type: string
          description: If present, indicates that the user has forced the classification to the specified value
        results:
          type: array
          description: Detailed classification results from each AI detection model
        details:
          type: array
          description: Details about object detection inside the image
    GetApiClassificationsVideoResponse:
      type: object
      properties:
        method:
          type: string
        headers:
          type: object
          properties:
            X-Api-Key:
              type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-Api-Key
security:
- apiKey: []
tags:
- name: Api