Get Classifier

{
  "build_error": null,
  "created_at": "2026-06-02T17:04:00Z",
  "description": "What counts as complex for the finance team.",
  "examples": [
    {
      "complexity": 0.05,
      "prompt": "What was our ARR at the end of Q3?"
    },
    {
      "complexity": 0.1,
      "prompt": "Who owns the intercompany elimination entries this quarter?"
    },
    {
      "complexity": 0.05,
      "prompt": "Send me the link to the FY26 opex budget."
    },
    {
      "complexity": 0.95,
      "prompt": "Reconcile Q3 deferred revenue against the billing schedules and explain every variance over $5k."
    },
    {
      "complexity": 0.9,
      "prompt": "Build the ARR bridge from Q2 to Q3 and tie it back to the GAAP revenue waterfall."
    },
    {
      "complexity": 0.95,
      "prompt": "Walk through the ASC 606 treatment of a 3-year ramp deal with a free first quarter."
    }
  ],
  "has_readout": true,
  "id": "5d7f9b1c-3e5a-4c7e-9a1b-6c8e0a2c4e69",
  "is_ready": true,
  "name": "Finance requests",
  "quality_report": {
    "accuracy": 1,
    "auc": 1,
    "examples": 6,
    "flagged_examples": [],
    "generic_accuracy": 0.83,
    "generic_auc": 0.89,
    "one_sided_terms": {
      "complex": [
        "revenue"
      ],
      "simple": []
    },
    "warnings": [
      "Add more examples: 10 or more on each side give steadier scores"
    ]
  },
  "status": "ready",
  "updated_at": "2026-09-14T09:30:00Z"
}

Return a classifier with its examples and quality report.

Authentication

AuthorizationBearer

A management key (mgmt_...), sent as Authorization: Bearer <key>. Reading /v1/routing-policies also accepts the organization’s gateway API keys; writing there needs a management key.

Path parameters

classifier_idstringRequiredformat: "uuid"

The classifier’s id.

Response

The classifier

build_errorstring or nullRead-only

Why the last build failed, when status is failed.

created_atdatetimeRead-only

descriptionstring or null

What the classifier is for.

exampleslist of objects

Labeled prompts: what your requests look like and how complex each one is, from 0 (simple) to 1 (complex). Scores further from 0.5 count more. The classifier is ready once at least 3 are below 0.5 and 3 are at or above it.

has_readoutbooleanRead-only

Whether routers that score with the difficulty readout use it too. Classifiers saved before readouts get one when their examples are next updated.

idstringRead-onlyformat: "uuid"

Send as a routing policy’s complexity_classifier_id to use it.

is_readybooleanRead-only

Whether it has a build that scores requests (also true while a rebuild runs). A policy using a classifier that isn’t ready scores with the built-in scorer.

namestring

Unique within the organization.

quality_reportobject or nullRead-only

null until the classifier is ready.

statusenum

building while the classifier builds in the background after a save (a few seconds to a minute), then ready, or not_enough_examples when either side of 0.5 has fewer than 3 examples, or failed. While a rebuild runs, policies keep using the previous build.

Allowed values:

updated_atdatetimeRead-only

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error