ArbiterQA

Search validations

Keyword / situation search over name, description, set names, and judgment content. Public — no key.

Get validation

Full assembled validation document by id or slug (judgment + params + standards + price). Public.

Recommend checks

Subject type + situation → ordered checks with why, pairs, and when-not-to. Public.

Compare checks

Side-by-side assembled docs for two validation ids/slugs. Public.

List validations

Catalog summaries (assembled). Optional subjectType / runnableOnly. Public.

List validation sets

Published Validation Sets (id, subject type, membership). Run one with POST /api/jobs validationSetId. Public.

Get validation set

One published Validation Set by id. Use its id as validationSetId on run_job or estimate_job. Public.

Describe job request

Static description of the unified POST /api/jobs body for url | static_html | email. Public.

Create account

Provision a new ArbiterQA account for an email address and return its API key (shown once). Public — no key needed, and the only tool here that creates anything. An email that already has an account is refused: sign in and mint a key from /keys instead. Humans can use `npx arbiterqa login`.

Explain error

Explain an API error code, or list every code the API can return to you when called with no arguments. Same reference as GET /api/errors. Public.

Check job request

Full door validation (normalize + guards) without charging or running. Plan gates use the Bearer tenant when a key is present. Public otherwise (ungated).

Estimate job

Quote credits for a job body without running it. Requires Bearer.

Run job

Create and execute a validation job. Soft spend: costs credits from the Bearer tenant balance (same as POST /api/jobs). Returns structured job results. Pass detail=verbose for results[].references and results[].note. Requires Bearer.

Get job

List jobs for the Bearer tenant, or one job when jobId is set. Pass detail=verbose for results[].references and results[].note. Requires Bearer.

Await email job

Poll an email job until it leaves pending or timeout (default 60s, max 30 min). Returns status + testEmail while pending. Pass detail=verbose for references/note on completion. Requires Bearer.

Fetch capture

Return the authenticated API path for a screenshot (does not dump binary). GET that path with the same Bearer key. Requires Bearer.

List email clients

Selectable (formFactor, client) pairs with plan inclusion. Requires Bearer.

Get email inbox

This organization's Rbtr capture inbox. Free plans share the environment inbox; paid plans have a private subdomain. Send mail here, then run an email job with emailCapture.mode "universal" and a source selector. Same as GET /api/email-capture/inbox. Requires Bearer.

Get credits

Balance, plan, cycle totals, and recent movements for the Bearer tenant. Requires Bearer.

List keys

Metadata for API keys belonging to the Bearer key holder (no secrets). Requires Bearer.

Get org

Organization overview for the Bearer key org. Requires Bearer.

List feedback due

Due feedback queue for the Bearer credential (agent channel). Requires Bearer.

List feedback questions

Serve a due feedback set (optional setId). Agent channel. Requires Bearer.

Submit feedback answers

Submit a completed feedback set (agent channel). Append-only; pays via ledger when priced. Requires Bearer.