API

Call the API

Brokers can send cases to Unde from their own tools with an API key. The Unde Labs team issues keys; there's no key management in the browser. Requests without a key work as they do on this site.

Send the key with every request

UNDE_API=https://undelabs.dev/api

curl -X POST "$UNDE_API/v1/cases/predict" \
  -H "X-API-Key: op_…" \
  -H "Content-Type: application/json" \
  -d '{"date": "2026-06-01", "facts": "Each heat gun is assembled in Thailand from 24 components…"}'

A key is op_ plus 43 characters, sent as the X-API-Key header. Responses are the same JSON this site uses, with the disclaimer on every one.

Limits

Each key has a number of requests per UTC day. Past it: 429 quota_exceeded, with Retry-After set to the next UTC day.
Model calls are limited per key: 20 a minute for light requests (predict, answers, ask, import, scenarios) and 4 a minute for plan searches. Over that: 429 rate_limited with Retry-After.
An unknown or disabled key gets 401 unauthorized. When the day's model budget is spent, model calls return 503 budget_reached.

Your cases

A key sees the demo cases and the cases it created. Its cases are hidden from everyone else.

Every endpoint, in the OpenAPI spec →