Developer API

Integrate classification into your stack

Classify from your ERP, e-commerce or scripts with a single call. API keys and cited, traceable results.

Name	Token	Last used	Created
Production	clz_live_a1b2…	2 h ago	Mar 12, 2026
ERP · SAP	clz_live_9f8e…	1 d ago	Feb 3, 2026
Staging	clz_test_4c5d…	Never	Jan 20, 2026

Classify with a single call

curl https://api.claz.ai/v1/classify \
  -H "x-api-key: $CLAZ_KEY" \
  -d '{"description": "Auriculares Bluetooth", "country": "AR"}'

Simple to implement in any language

One REST call to create the classification and another to read the result. No SDK required — use it from the language you already work in.

const base = "https://api.claz.ai/v1";
const key = process.env.CLAZ_KEY!;

const { id } = await fetch(`${base}/classifications`, {
  method: "POST",
  headers: { "x-api-key": key, "content-type": "application/json" },
  body: JSON.stringify({ description: "Auriculares Bluetooth", country: "AR" }),
}).then((r) => r.json());

// Poll the status until the run is done, with a timeout.
for (let i = 0; i < 30; i++) {
  const run = await fetch(`${base}/classifications/${id}`, {
    headers: { "x-api-key": key },
  }).then((r) => r.json());
  if (run.status === "completed") return run.candidates[0];
  if (run.status === "failed") throw new Error("classification failed");
  await new Promise((r) => setTimeout(r, 2000));
}
throw new Error("timed out");

Structured response, ready for your system

You get the code, confidence, reasoning and citations as JSON — easy to store or show in your ERP or e-commerce.

200 OK · application/json

{
  "id": "run_9f8e7d",
  "status": "completed",
  "confidence": 94,
  "candidates": [
    {
      "rank": 1,
      "code": "8518.30.00",
      "description": "Auriculares, incluso combinados con micrófono",
      "confidence": 94
    }
  ],
  "reasoning": "Se clasifica por su función principal … (RGI 1).",
  "citations": ["Nota 3 del Capítulo 85", "Nota explicativa 85.18"]
}