Clarity Classifications API

The classifications API from Clarity — 3 operation(s) for classifications.

Operations 3

GET /api/v1/classifications/{run_id} Get Classification Run #
GET /api/v1/classifications/{run_id}/tickets Get Classification Tickets #
GET /api/v1/classifications/{run_id}/export Export Classification Run #

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/onclarity-com:onclarity-com-classifications-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

onclarity-com-classifications-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Fast Classifications API
  version: 0.1.0
tags:
- name: Classifications
paths:
  /api/v1/classifications/{run_id}:
    get:
      tags:
      - Classifications
      summary: Get Classification Run
      description: 'The run''s manifest: definition, counts, per-task label histograms.'
      operationId: get_classification_run_api_v1_classifications__run_id__get
      security:
      - HTTPBearer: []
      parameters:
      - name: run_id
        in: path
        required: true
        schema:
          type: integer
          title: Run Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClassificationRunManifest'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/classifications/{run_id}/tickets:
    get:
      tags:
      - Classifications
      summary: Get Classification Tickets
      description: 'Label rows (with the stored inputs the model saw), paginated; optionally narrowed

        to one task and/or one label value.'
      operationId: get_classification_tickets_api_v1_classifications__run_id__tickets_get
      security:
      - HTTPBearer: []
      parameters:
      - name: run_id
        in: path
        required: true
        schema:
          type: integer
          title: Run Id
      - name: task
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Task
      - name: label
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Label
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          default: 0
          title: Offset
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 1000
          minimum: 1
          default: 100
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClassificationTicketsPage'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/classifications/{run_id}/export:
    get:
      tags:
      - Classifications
      summary: Export Classification Run
      description: The run's label rows as a downloadable CSV or JSONL, generated on demand.
      operationId: export_classification_run_api_v1_classifications__run_id__export_get
      security:
      - HTTPBearer: []
      parameters:
      - name: run_id
        in: path
        required: true
        schema:
          type: integer
          title: Run Id
      - name: format
        in: query
        required: false
        schema:
          type: string
          pattern: ^(csv|jsonl)$
          default: csv
          title: Format
      - name: task
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Task
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ClassificationTicketsPage:
      properties:
        run_id:
          type: integer
          title: Run Id
        task:
          anyOf:
          - type: string
          - type: 'null'
          title: Task
        label:
          anyOf:
          - type: string
          - type: 'null'
          title: Label
        offset:
          type: integer
          title: Offset
        limit:
          type: integer
          title: Limit
        rows:
          items:
            $ref: '#/components/schemas/ClassificationLabelRow'
          type: array
          title: Rows
      type: object
      required:
      - run_id
      - offset
      - limit
      - rows
      title: ClassificationTicketsPage
    ClassificationRunManifest:
      properties:
        run_id:
          type: integer
          title: Run Id
        project_id:
          type: integer
          title: Project Id
        mode:
          type: string
          title: Mode
        status:
          type: string
          title: Status
        purpose:
          anyOf:
          - type: string
          - type: 'null'
          title: Purpose
        snapshot_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Snapshot At
        population:
          anyOf:
          - type: integer
          - type: 'null'
          title: Population
        selected:
          type: integer
          title: Selected
          default: 0
        succeeded:
          type: integer
          title: Succeeded
          default: 0
        failed:
          type: integer
          title: Failed
          default: 0
        sample_size:
          anyOf:
          - type: integer
          - type: 'null'
          title: Sample Size
        model:
          anyOf:
          - type: string
          - type: 'null'
          title: Model
        tasks:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Tasks
          default: []
        input_fields:
          items:
            type: string
          type: array
          title: Input Fields
          default: []
        label_counts:
          additionalProperties:
            additionalProperties:
              type: integer
            type: object
          type: object
          title: Label Counts
          default: {}
        usage:
          additionalProperties: true
          type: object
          title: Usage
          default: {}
        created_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Created At
        completed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Completed At
      type: object
      required:
      - run_id
      - project_id
      - mode
      - status
      title: ClassificationRunManifest
    ClassificationLabelRow:
      properties:
        ticket_id:
          type: string
          title: Ticket Id
        ds:
          anyOf:
          - type: string
          - type: 'null'
          title: Ds
        task:
          type: string
          title: Task
        label:
          title: Label
        explanation:
          anyOf:
          - type: string
          - type: 'null'
          title: Explanation
        status:
          type: string
          title: Status
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
        inputs:
          additionalProperties: true
          type: object
          title: Inputs
          default: {}
      type: object
      required:
      - ticket_id
      - task
      - status
      title: ClassificationLabelRow
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    HTTPBasic:
      type: http
      scheme: basic