API · v1

Provjeravajte kreative iz vlastitog pipelinea.

REST površina s autentifikacijom API ključem. Isti engine, isti packovi, iste presude kao aplikacija — pročitajte cijelu specifikaciju prije nego se igdje registrirate.

Preuzmi specifikaciju OpenAPI 3.1 (YAML)32 KBOpenAPI 3.1.0 · v1.0.0Bez registracije. Za čitanje ključ nije potreban.

Autentifikacija

Ključ šaljite u X-API-Key ili kao Bearer token, ako vaš klijent radi tako. Ključevi imaju minimalne ovlasti i sami ih izrađujete.

Osnovni URL

https://api.angleverdict.com

apiKey

X-API-Key: av_live_...

bearerAuth

Authorization: Bearer av_live_...

curl -X POST https://api.angleverdict.com/v1/check \
  -H "X-API-Key: av_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"Melt fat while you sleep","vertical":"nutra","jurisdictions":["us"]}'

Na ovoj stranici

Endpointi

Svaki endpoint i scope koji mu treba. Tablica se generira iz specifikacije pa ne može zaostati za API-jem.

Metoda	Putanja	Opseg
GET	/v1/me	account:read
GET	/v1/usage	account:read
POST	/v1/check	check:write
GET	/v1/checks	check:read
GET	/v1/checks/{id}	check:read

GET/v1/meaccount:read

Introspect the authenticating API key

Returns the tenant + key identity and granted scopes of the authenticating API key. Proves authentication works.

Odgovori

200MeResponse

The authenticating key's identity + scopes.

Primjer

{
  "tenant_id": "11111111-1111-1111-1111-111111111111",
  "api_key_id": "ak_7f3c1d",
  "name": "Production integration key",
  "scopes": [
    "check:write",
    "check:read",
    "account:read"
  ]
}

401auth.api_key_invalidProblemJson

Missing, invalid, or revoked API key (auth.api_key_invalid).

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_invalid",
  "title": "Api Key Invalid",
  "status": 401,
  "detail": "API key missing or invalid",
  "code": "auth.api_key_invalid",
  "instance": "/v1/me",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000000"
}

403auth.api_key_insufficient_scopeProblemJson

The key lacks a scope the operation requires (auth.api_key_insufficient_scope). context carries required + granted.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_insufficient_scope",
  "title": "Api Key Insufficient Scope",
  "status": 403,
  "detail": "API key lacks the scope(s) required for this operation",
  "code": "auth.api_key_insufficient_scope",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000001",
  "context": {
    "required": [
      "check:write"
    ],
    "granted": [
      "check:read"
    ]
  }
}

429auth.api_key_rate_limitedProblemJson

Per-key ingress rate limit exceeded (auth.api_key_rate_limited), or the downstream per-tenant filter limit (v1.rate_limited). The delay until the next token is in context.retryAfterMs / context.retry_after_ms.

Retry-AfterSeconds to wait before retrying.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_rate_limited",
  "title": "Api Key Rate Limited",
  "status": 429,
  "detail": "API key rate limit exceeded; retry after the indicated delay",
  "code": "auth.api_key_rate_limited",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000003",
  "context": {
    "retryAfterMs": 1500
  }
}

GET/v1/usageaccount:read

Introspect the key's tier + remaining rate-limit budget

Returns the authenticating key's rate-limit tier and the current per-key ingress budget (limit, window, remaining, reset time). The remaining/reset values reflect the SAME per-key bucket the guard enforces.

FREE + non-consuming: this endpoint PEEKS the bucket without spending a token, so polling /v1/usage never affects your remaining budget. (The guard still consumes one token to admit the GET itself, exactly as for any authenticated /v1 request, so remaining is the post-admission value.)

Odgovori

200UsageResponse

The key's tier + current per-key rate-limit budget.

Primjer

{
  "tier": "scale",
  "rate_limit": {
    "limit": 6000,
    "window_seconds": 60,
    "remaining": 5987,
    "reset_at": "2026-06-09T12:00:01.000Z"
  }
}

401auth.api_key_invalidProblemJson

Missing, invalid, or revoked API key (auth.api_key_invalid).

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_invalid",
  "title": "Api Key Invalid",
  "status": 401,
  "detail": "API key missing or invalid",
  "code": "auth.api_key_invalid",
  "instance": "/v1/me",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000000"
}

403auth.api_key_insufficient_scopeProblemJson

The key lacks a scope the operation requires (auth.api_key_insufficient_scope). context carries required + granted.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_insufficient_scope",
  "title": "Api Key Insufficient Scope",
  "status": 403,
  "detail": "API key lacks the scope(s) required for this operation",
  "code": "auth.api_key_insufficient_scope",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000001",
  "context": {
    "required": [
      "check:write"
    ],
    "granted": [
      "check:read"
    ]
  }
}

429auth.api_key_rate_limitedProblemJson

Retry-AfterSeconds to wait before retrying.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_rate_limited",
  "title": "Api Key Rate Limited",
  "status": 429,
  "detail": "API key rate limit exceeded; retry after the indicated delay",
  "code": "auth.api_key_rate_limited",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000003",
  "context": {
    "retryAfterMs": 1500
  }
}

POST/v1/checkcheck:write

Check a creative against compliance rules

Classifies text against the active policy packs for the caller's tenant and returns the verdict + findings. Exercises the same classifier as the interactive surface.

Supply an Idempotency-Key header to make retries safe: a repeated call with the same key within 24h replays the cached verdict and sets the Idempotent-Replayed: true response header. On a multi-market request the key is scoped PER MARKET internally, so a retry can never serve one market's verdict as another's.

Multi-market. Pass jurisdictions to judge one creative against several regulatory markets in a single call. Each market is a separate evaluation with its own pack and audit row, and consumes one check from your monthly quota — three markets cost three checks. Read complete before treating a safe verdict as a clearance.

Quota. This endpoint is metered against the same monthly allowance as the interactive surface and returns 402 at the cap.

Parametri

Naziv	Tip	Opis
Idempotency-Keyneobaveznoheader	string	Opaque client-supplied key. A repeated POST /v1/check with the same key within 24h replays the cached verdict (and sets the `Idempotent-Replayed: true` response header). Empty/whitespace-only is ignored.

Tijelo zahtjeva

application/json · CheckRequest

Primjer

{
  "text": "Clinically proven to melt 20 pounds of belly fat in one week with no diet or exercise."
}

Odgovori

200CheckResponse

The classification verdict.

Idempotent-ReplayedPresent and `true` when this response replays a verdict cached under the supplied `Idempotency-Key` (not a fresh classify).

Primjer

{
  "verdict": "banned-claim",
  "findings": [
    {
      "rule_id": "ftc.weight-loss.fat-melt",
      "severity": "banned",
      "rationale": "Implies effortless rapid fat loss — an FTC \"Gut Check\" prohibited claim.",
      "citation": "FTC Act §5(a)",
      "source_url": "https://www.ftc.gov/legal-library/browse/statutes/federal-trade-commission-act"
    }
  ],
  "policy_version": "2026.06.01",
  "classifier_version": "hybrid-1.4.0",
  "confidence": 0.97,
  "vertical_id": "nutra-us",
  "audit_id": "01HX7K4F0PZQ2T6PJ9N2W6QYRA",
  "complete": true,
  "jurisdictions": [
    {
      "jurisdiction": "us",
      "status": "judged",
      "vertical_id": "nutra-us",
      "verdict": "banned-claim",
      "audit_id": "01HX7K4F0PZQ2T6PJ9N2W6QYRA"
    }
  ]
}

401auth.api_key_invalidProblemJson

Missing, invalid, or revoked API key (auth.api_key_invalid).

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_invalid",
  "title": "Api Key Invalid",
  "status": 401,
  "detail": "API key missing or invalid",
  "code": "auth.api_key_invalid",
  "instance": "/v1/me",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000000"
}

402filter.quota_exceededProblemJson

The tenant's monthly check allowance is exhausted (filter.quota_exceeded), or the request's market count would exceed what is left. context carries tier, current_usage, hard_cap and — on a multi-market request — requested_cost.

A multi-market check consumes ONE CHECK PER MARKET, so a request for three markets is refused when fewer than three remain rather than partially served.

Primjer

{
  "type": "https://errors.angleverdict.com/filter.quota_exceeded",
  "title": "Quota Exceeded",
  "status": 402,
  "detail": "Monthly check quota reached for this plan. Upgrade or contact us to raise the cap.",
  "code": "filter.quota_exceeded",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000000"
}

403auth.api_key_insufficient_scopeProblemJson

The key lacks a scope the operation requires (auth.api_key_insufficient_scope). context carries required + granted.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_insufficient_scope",
  "title": "Api Key Insufficient Scope",
  "status": 403,
  "detail": "API key lacks the scope(s) required for this operation",
  "code": "auth.api_key_insufficient_scope",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000001",
  "context": {
    "required": [
      "check:write"
    ],
    "granted": [
      "check:read"
    ]
  }
}

422validation.failedProblemJson

Request body / query failed validation (validation.failed).

Primjer

{
  "type": "https://errors.angleverdict.com/validation.failed",
  "title": "Validation Failed",
  "status": 422,
  "detail": "text must contain at least 12 character(s)",
  "code": "validation.failed",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000002"
}

429auth.api_key_rate_limitedProblemJson

Retry-AfterSeconds to wait before retrying.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_rate_limited",
  "title": "Api Key Rate Limited",
  "status": 429,
  "detail": "API key rate limit exceeded; retry after the indicated delay",
  "code": "auth.api_key_rate_limited",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000003",
  "context": {
    "retryAfterMs": 1500
  }
}

503v1.llm_degradedProblemJson

Upstream LLM degraded; retry later (v1.llm_degraded).

Primjer

{
  "type": "https://errors.angleverdict.com/v1.llm_degraded",
  "title": "Llm Degraded",
  "status": 503,
  "detail": "request could not be completed (llm_degraded)",
  "code": "v1.llm_degraded",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000004",
  "context": {
    "retry_after_ms": 5000
  }
}

GET/v1/checkscheck:read

List past verdicts (keyset-paginated)

Returns the caller tenant's past verdicts, newest first, with opaque keyset (seek) cursor pagination. The tenant scope is taken from the API key — never from a query parameter.

Parametri

Naziv Tip Opis

Naziv	Tip	Opis
limitneobaveznoquery	integer	Page size. Default 25, capped at 100. default 25 · minimum 1 · maximum 100
cursorneobaveznoquery	string	Opaque continuation token from a previous response's `next_cursor`. Treat it as a blob and echo it verbatim. A malformed/tampered token is treated as "first page" (fail-safe). minLength 1 · maxLength 512
verdictneobaveznoquery	Verdict	Optional filter over the public verdict vocabulary.

limitneobaveznoquery

integer

Page size. Default 25, capped at 100.

default 25 · minimum 1 · maximum 100

cursorneobaveznoquery

string

Opaque continuation token from a previous response's next_cursor. Treat it as a blob and echo it verbatim. A malformed/tampered token is treated as "first page" (fail-safe).

minLength 1 · maxLength 512

verdictneobaveznoquery

Verdict

Optional filter over the public verdict vocabulary.

Odgovori

200ChecksListResponse

A page of verdict summaries + the next cursor.

Primjer

{
  "data": [
    {
      "id": "3210",
      "verdict": "banned-claim",
      "confidence": 0.97,
      "created_at": "2026-06-09T12:00:00.000Z",
      "vertical_id": "ftc-supplements",
      "snippet": "Clinically proven to melt 20 pounds of belly fat…"
    },
    {
      "id": "3209",
      "verdict": "safe",
      "confidence": 1,
      "created_at": "2026-06-09T11:58:00.000Z",
      "vertical_id": "ftc-supplements",
      "snippet": "Supports your wellness routine."
    }
  ],
  "next_cursor": "eyJjIjoiMjAyNi0wNi0wOVQxMTo1ODowMC4wMDBaIiwiaSI6IjMyMDkifQ"
}

401auth.api_key_invalidProblemJson

Missing, invalid, or revoked API key (auth.api_key_invalid).

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_invalid",
  "title": "Api Key Invalid",
  "status": 401,
  "detail": "API key missing or invalid",
  "code": "auth.api_key_invalid",
  "instance": "/v1/me",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000000"
}

403auth.api_key_insufficient_scopeProblemJson

The key lacks a scope the operation requires (auth.api_key_insufficient_scope). context carries required + granted.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_insufficient_scope",
  "title": "Api Key Insufficient Scope",
  "status": 403,
  "detail": "API key lacks the scope(s) required for this operation",
  "code": "auth.api_key_insufficient_scope",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000001",
  "context": {
    "required": [
      "check:write"
    ],
    "granted": [
      "check:read"
    ]
  }
}

422validation.failedProblemJson

Request body / query failed validation (validation.failed).

Primjer

{
  "type": "https://errors.angleverdict.com/validation.failed",
  "title": "Validation Failed",
  "status": 422,
  "detail": "text must contain at least 12 character(s)",
  "code": "validation.failed",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000002"
}

429auth.api_key_rate_limitedProblemJson

Retry-AfterSeconds to wait before retrying.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_rate_limited",
  "title": "Api Key Rate Limited",
  "status": 429,
  "detail": "API key rate limit exceeded; retry after the indicated delay",
  "code": "auth.api_key_rate_limited",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000003",
  "context": {
    "retryAfterMs": 1500
  }
}

GET/v1/checks/{id}check:read

Get a single past verdict

Returns the full public detail for one past verdict by id. Tenant- scoped: an unknown id, an id belonging to another tenant, and a non- verdict audit row are all indistinguishable 404 v1.check_not_found (no existence oracle).

Parametri

Naziv	Tip	Opis
idobaveznopath	string	The verdict id (from a list-row `id` or a previous detail).

Odgovori

200PublicCheckDetail

The full public verdict detail.

Primjer

{
  "id": "3210",
  "verdict": "banned-claim",
  "confidence": 0.97,
  "created_at": "2026-06-09T12:00:00.000Z",
  "vertical_id": "ftc-supplements",
  "snippet": "Clinically proven to melt 20 pounds of belly fat…",
  "findings": [
    {
      "rule_id": "ftc.weight-loss.fat-melt",
      "severity": "banned",
      "rationale": "Implies effortless rapid fat loss — an FTC \"Gut Check\" prohibited claim."
    }
  ],
  "policy_version": "2026.06.01",
  "classifier_version": "hybrid-1.4.0",
  "retained_until": "2027-06-09T12:00:00.000Z"
}

401auth.api_key_invalidProblemJson

Missing, invalid, or revoked API key (auth.api_key_invalid).

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_invalid",
  "title": "Api Key Invalid",
  "status": 401,
  "detail": "API key missing or invalid",
  "code": "auth.api_key_invalid",
  "instance": "/v1/me",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000000"
}

403auth.api_key_insufficient_scopeProblemJson

The key lacks a scope the operation requires (auth.api_key_insufficient_scope). context carries required + granted.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_insufficient_scope",
  "title": "Api Key Insufficient Scope",
  "status": 403,
  "detail": "API key lacks the scope(s) required for this operation",
  "code": "auth.api_key_insufficient_scope",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000001",
  "context": {
    "required": [
      "check:write"
    ],
    "granted": [
      "check:read"
    ]
  }
}

404v1.check_not_foundProblemJson

No verdict with that id for the caller's tenant (v1.check_not_found). Also covers cross-tenant ids and non-verdict rows — indistinguishable from "unknown".

Primjer

{
  "type": "https://errors.angleverdict.com/v1.check_not_found",
  "title": "Check Not Found",
  "status": 404,
  "detail": "No verdict found with id \"3210\"",
  "code": "v1.check_not_found",
  "instance": "/v1/checks/3210",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000005"
}

429auth.api_key_rate_limitedProblemJson

Retry-AfterSeconds to wait before retrying.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_rate_limited",
  "title": "Api Key Rate Limited",
  "status": 429,
  "detail": "API key rate limit exceeded; retry after the indicated delay",
  "code": "auth.api_key_rate_limited",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000003",
  "context": {
    "retryAfterMs": 1500
  }
}

Podatkovni model

Svaki objekt koji API prima ili vraća, s poljima, tipovima i ograničenjima iz specifikacije.

Verdict

The public verdict vocabulary, emitted 1:1 by the classifier (VerdictKind).

Jedna od vrijednostisafe · risky-flagged · banned-claim

Finding

A single rule finding contributing to a verdict.

Naziv	Tip	Opis
rule_idobavezno	string	Stable id of the policy rule that fired.
severityobavezno	string	Finding severity. Jedna od vrijednosti`banned` · `risky` · `info`
rationaleobavezno	string	Human-readable explanation of why the rule fired.
citationneobavezno	string	The provision this rule applies, e.g. "16 CFR 255.5(a)". Added 2026-08-30. OPTIONAL: absent means no instrument claims the rule yet, which is different from an empty citation. On GET /v1/checks/{id} this is the provision recorded WHEN THE VERDICT WAS MADE, not whatever the rule cites today.
source_urlneobavezno	string	Link to the published text of `citation`. Present only when the provision has a stable public URL — the packs are agent-authored and not attorney-signed, so being able to read the law and judge for yourself is part of the product. format uri

MeResponse

Identity + scopes of the authenticating API key.

Naziv	Tip	Opis
tenant_idobavezno	string	The tenant the key belongs to.
api_key_idobavezno	string	The key's id.
nameobavezno	string	Human label of the key.
scopesobavezno	string[]	Granted scopes (empty = full access). Jedna od vrijednosti`check:write` · `check:read` · `account:read`

UsageResponse

Per-key rate-limit usage for GET /v1/usage. The values mirror the per-key ingress bucket the ApiKeyGuard enforces; reading them is free (non-consuming peek).

Naziv	Tip	Opis
tierobavezno	string	The resolved rate-limit tier (`free` / `starter` / `scale`), or `default` when the tenant has no tier set (→ the 600/min default bucket, legacy flat behaviour).
rate_limitobavezno	object
limitobavezno	integer	Bucket capacity — max requests allowed per window. minimum 1
window_secondsobavezno	integer	Window length in seconds. minimum 1
remainingobavezno	integer	Tokens currently left in the bucket (post-admission). minimum 0
reset_atobavezno	string	When the bucket fully refills (ISO-8601). format date-time

CheckRequest

Body for POST /v1/check.

Every field except text is OPTIONAL and ADDITIVE (2026-08-13): a client that has always sent { "text": "..." } is unaffected. What changed for strict clients is that additionalProperties: false now admits four more names.

Before these fields existed, the pack was resolved server-side from the tenant's settings, so an API caller could not choose what their creative was judged against — and a vertical with no pinned pack was silently judged under the default nutra pack.

Naziv	Tip	Opis
textobavezno	string	The creative text to classify. minLength 12 · maxLength 5000
vertical_idneobavezno	string	Explicit policy pack. Entitlement-checked: `403` when the tenant is not entitled, `404` when the id is not in the catalog. Both the canonical 4D form (`meta-nutra-us`) and the legacy form (`nutra-us`) are accepted and normalise to the same pack. Omitted → the tenant's default pack. pattern ^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$
verticalneobavezno	string	Vertical hint. Omitted → the tenant's configured default → the catalog default (`nutra`). A vertical with no active policy pack is refused with `422` rather than evaluated under the default pack, because a confident wrong-frame verdict (a crypto ad judged by nutra rules) is worse than an explicit gap.
jurisdictionneobavezno	Jurisdiction
platformneobavezno	string	The ad platform (default `meta`). A platform is a request dimension, not a pack id: a `tiktok` check is judged by TikTok's policy layer on the same underlying law. An unsupported platform is refused with `422`.
jurisdictionsneobavezno	Jurisdiction[]	MULTI-market selection. Each market is a SEPARATE evaluation with its own policy pack, its own audit row and its own verdict, and each consumes one check from the monthly quota — exactly as the interactive surface counts it. A market with no grounded pack for the requested vertical is reported as `not_covered` in the response rather than substituted; when EVERY requested market is ungrounded the request is refused with `422`. Merges with the singular `jurisdiction` when both are sent. Requesting more than the maximum is refused rather than truncated: a silent truncation would read as full coverage. minItems 1 · maxItems 4

Jurisdiction

A regulatory market. us is the default when none is specified.

Jedna od vrijednostius · eu · de · uk · fr · es · it · nl

JurisdictionOutcome

One market's own answer within a check.

status is the whole contract:

judged — a real verdict for this market, with its own pack and audit row.
not_covered — no grounded pack for this (vertical × market) cell. NOT an error, and explicitly NOT a pass.
error — this market's evaluation failed on its own (rate limit, LLM unavailable) while others may have succeeded. Failures are isolated per market by design: one 429 flags one market, not every selected one.

Naziv	Tip	Opis
jurisdictionobavezno	Jurisdiction
statusobavezno	string	Jedna od vrijednosti`judged` · `not_covered` · `error`
vertical_idneobavezno	string	The pack whose rules actually ran for this market.
via_baselineneobavezno	Jurisdiction
verdictneobavezno	Verdict
findingsneobavezno	Finding[]
audit_idneobavezno	string	This market's own audit-row id.
reasonneobavezno	string	Present on `not_covered` / `error` — why.

CheckResponse

The classification verdict returned by POST /v1/check.

The TOP-LEVEL fields describe the WORST-CASE market among those judged, not the first one requested: a client that reads only the top level must never see a pass it does not have. jurisdictions is authoritative for per-market detail.

Naziv	Tip	Opis
verdictobavezno	Verdict
findingsobavezno	Finding[]
policy_versionobavezno	string	Version of the policy pack set applied.
classifier_versionobavezno	string	Version of the classifier that produced the verdict.
confidenceobavezno	number \| null	Classifier confidence in [0, 1], or null for rule-based verdicts with no LLM confidence. minimum 0 · maximum 1
vertical_idobavezno	string	The pack whose rules actually ran. Added 2026-08-13 — without it a caller could not distinguish a verdict from their intended pack from one silently produced by the default pack.
audit_idobavezno	string	The audit-row id for the worst-case market; use with GET /v1/checks/{id}.
jurisdictionsobavezno	JurisdictionOutcome[]	Every REQUESTED market, in the order asked for, including the ones we could not judge. Always present — one entry for a single-market check — so clients read one shape rather than two. minItems 1
completeobavezno	boolean	`false` when ANY requested market went unjudged (`not_covered` or `error`). GATE YOUR "cleared" RENDERING ON THIS, not on `verdict` alone. `verdict: safe` with `complete: false` means "clear in the markets we judged" — treating it as "clear everywhere" would report a clearance for a market that was never examined.
rejected_jurisdictionsneobavezno	object[]	Markets the caller NAMED that we do not recognise. Reported rather than dropped: an unrecognised market is a client bug and must not be mistaken for coverage.
valueobavezno	string
reasonobavezno	string	Jedna od vrijednosti`invalid` · `over-cap`

PublicCheckSummary

List-row projection for GET /v1/checks (non-sensitive subset).

Naziv	Tip	Opis
idobavezno	string	The verdict id (use as the path id for GET /v1/checks/:id).
verdictobavezno	string	The stored verdict label (classifier vocabulary).
confidenceobavezno	number	Confidence in [0, 1]; 1 for rule-based rows. minimum 0 · maximum 1
created_atobavezno	string	When the verdict was produced (ISO-8601). format date-time
vertical_idobavezno	string	The policy pack that produced the verdict.
snippetobavezno	string	PII-redacted excerpt (≤120 chars) of the checked text.

PublicCheckDetail

Full public detail for GET /v1/checks/:id.

Naziv	Tip	Opis
idobavezno	string
verdictobavezno	string
confidenceobavezno	number	minimum 0 · maximum 1
created_atobavezno	string	format date-time
vertical_idobavezno	string
snippetobavezno	string
findingsobavezno	Finding[]
policy_versionobavezno	string
classifier_versionobavezno	string
retained_untilobavezno	string	When this verdict row is scheduled for deletion (ISO-8601). format date-time

ChecksListResponse

A page of verdict summaries.

Naziv	Tip	Opis
dataobavezno	PublicCheckSummary[]
next_cursorobavezno	string \| null	Opaque cursor for the next page, or null when there are no more rows. Echo it back verbatim in the `cursor` query parameter.

ProblemJson

RFC 9457 Problem+JSON error envelope. Branch on code.

Naziv	Tip	Opis
typeobavezno	string	`${base}/{code}` — dereferenceable error type URI. format uri
titleobavezno	string	Title-cased from `code`.
statusobavezno	integer	HTTP status (mirrors the response status line).
detailobavezno	string	Safe-to-expose human message — never internal/PII.
codeobavezno	string	The stable machine key. Branch on this, not detail/status.
instanceneobavezno	string	The request path (when known).
request_idneobavezno	string	Correlation id — echo to support to find server logs.
contextneobavezno	object	Machine-readable structured data (e.g. retryAfterMs).

Pogreške

Svaka pogreška je Problem+JSON po RFC 9457. Granajte se po stabilnom polju code, nikad po detail ili status — ta se mijenjaju, code ne.

Status	Kod	Kada se događa
401	auth.api_key_invalid	Missing, invalid, or revoked API key (`auth.api_key_invalid`).
402	filter.quota_exceeded	The tenant's monthly check allowance is exhausted (`filter.quota_exceeded`), or the request's market count would exceed what is left. `context` carries `tier`, `current_usage`, `hard_cap` and — on a multi-market request — `requested_cost`. A multi-market check consumes ONE CHECK PER MARKET, so a request for three markets is refused when fewer than three remain rather than partially served.
403	auth.api_key_insufficient_scope	The key lacks a scope the operation requires (`auth.api_key_insufficient_scope`). `context` carries `required` + `granted`.
404	v1.check_not_found	No verdict with that id for the caller's tenant (`v1.check_not_found`). Also covers cross-tenant ids and non-verdict rows — indistinguishable from "unknown".
422	validation.failed	Request body / query failed validation (`validation.failed`).
429	auth.api_key_rate_limited	Per-key ingress rate limit exceeded (`auth.api_key_rate_limited`), or the downstream per-tenant filter limit (`v1.rate_limited`). The delay until the next token is in `context.retryAfterMs` / `context.retry_after_ms`.
503	v1.llm_degraded	Upstream LLM degraded; retry later (`v1.llm_degraded`).

Svaki ključ ima vlastiti minutni budžet prema vašem planu. Kad se potroši, stiže 429 s čekanjem u context.retryAfterMs.

Kako dobiti ključ

Ključevi se izrađuju u vašem workspaceu, s opsezima koje odaberete. Taj je zaslon iza prijave jer dijeli vjerodajnice — ova stranica nije.

Izradite ključ u workspaceu →

Pristup API-ju uključen je u svaki plan. Provjere putem API-ja troše istu mjesečnu kvotu kao i aplikacija, a provjera za više tržišta troši jednu provjeru po tržištu.

Pogledaj planove i ograničenja →

POST/v1/checkcheck:write

Check a creative against compliance rules

Classifies text against the active policy packs for the caller's tenant and returns the verdict + findings. Exercises the same classifier as the interactive surface.

Quota. This endpoint is metered against the same monthly allowance as the interactive surface and returns 402 at the cap.

Parametri

Naziv	Tip	Opis
Idempotency-Keyneobaveznoheader	string	Opaque client-supplied key. A repeated POST /v1/check with the same key within 24h replays the cached verdict (and sets the `Idempotent-Replayed: true` response header). Empty/whitespace-only is ignored.

Tijelo zahtjeva

application/json · CheckRequest

Primjer

{
  "text": "Clinically proven to melt 20 pounds of belly fat in one week with no diet or exercise."
}

Odgovori

200CheckResponse

The classification verdict.

Idempotent-ReplayedPresent and `true` when this response replays a verdict cached under the supplied `Idempotency-Key` (not a fresh classify).

Primjer

{
  "verdict": "banned-claim",
  "findings": [
    {
      "rule_id": "ftc.weight-loss.fat-melt",
      "severity": "banned",
      "rationale": "Implies effortless rapid fat loss — an FTC \"Gut Check\" prohibited claim.",
      "citation": "FTC Act §5(a)",
      "source_url": "https://www.ftc.gov/legal-library/browse/statutes/federal-trade-commission-act"
    }
  ],
  "policy_version": "2026.06.01",
  "classifier_version": "hybrid-1.4.0",
  "confidence": 0.97,
  "vertical_id": "nutra-us",
  "audit_id": "01HX7K4F0PZQ2T6PJ9N2W6QYRA",
  "complete": true,
  "jurisdictions": [
    {
      "jurisdiction": "us",
      "status": "judged",
      "vertical_id": "nutra-us",
      "verdict": "banned-claim",
      "audit_id": "01HX7K4F0PZQ2T6PJ9N2W6QYRA"
    }
  ]
}

401auth.api_key_invalidProblemJson

Missing, invalid, or revoked API key (auth.api_key_invalid).

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_invalid",
  "title": "Api Key Invalid",
  "status": 401,
  "detail": "API key missing or invalid",
  "code": "auth.api_key_invalid",
  "instance": "/v1/me",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000000"
}

402filter.quota_exceededProblemJson

A multi-market check consumes ONE CHECK PER MARKET, so a request for three markets is refused when fewer than three remain rather than partially served.

Primjer

{
  "type": "https://errors.angleverdict.com/filter.quota_exceeded",
  "title": "Quota Exceeded",
  "status": 402,
  "detail": "Monthly check quota reached for this plan. Upgrade or contact us to raise the cap.",
  "code": "filter.quota_exceeded",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000000"
}

403auth.api_key_insufficient_scopeProblemJson

The key lacks a scope the operation requires (auth.api_key_insufficient_scope). context carries required + granted.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_insufficient_scope",
  "title": "Api Key Insufficient Scope",
  "status": 403,
  "detail": "API key lacks the scope(s) required for this operation",
  "code": "auth.api_key_insufficient_scope",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000001",
  "context": {
    "required": [
      "check:write"
    ],
    "granted": [
      "check:read"
    ]
  }
}

422validation.failedProblemJson

Request body / query failed validation (validation.failed).

Primjer

{
  "type": "https://errors.angleverdict.com/validation.failed",
  "title": "Validation Failed",
  "status": 422,
  "detail": "text must contain at least 12 character(s)",
  "code": "validation.failed",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000002"
}

429auth.api_key_rate_limitedProblemJson

Retry-AfterSeconds to wait before retrying.

Primjer

{
  "type": "https://errors.angleverdict.com/auth.api_key_rate_limited",
  "title": "Api Key Rate Limited",
  "status": 429,
  "detail": "API key rate limit exceeded; retry after the indicated delay",
  "code": "auth.api_key_rate_limited",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000003",
  "context": {
    "retryAfterMs": 1500
  }
}

503v1.llm_degradedProblemJson

Upstream LLM degraded; retry later (v1.llm_degraded).

Primjer

{
  "type": "https://errors.angleverdict.com/v1.llm_degraded",
  "title": "Llm Degraded",
  "status": 503,
  "detail": "request could not be completed (llm_degraded)",
  "code": "v1.llm_degraded",
  "instance": "/v1/check",
  "request_id": "7f3c1d2e-0000-4000-8000-000000000004",
  "context": {
    "retry_after_ms": 5000
  }
}