s2ar

The API

https://api.s2ar.dev · every tool answers GET with query parameters and POST with a JSON body

Evidence an agent can hand on: each answer measures something and comes back with the evidence and a signed record anyone can verify, free.

Paying

Sales are paused since 2026-10-16 (the charter, clause 3): no card pack is sold and no rail is offered. A key already bought keeps working, and verify, the free calls and the environments stay open.

A call that fails is never charged.

The tools

toolroutea callfree a day
sym map/v1/sym/map$0.0110
sym ls/v1/sym/ls$0.00510
sym read/v1/sym/read$0.00510
sym find/v1/sym/find$0.00510
sym where/v1/sym/where$0.0110
score/v1/score$0.00510
assert/v1/assert$0.00510
inspect/v1/x402/inspect$0.00510
diff/v1/diff$0.00510
extract_text/v1/extract_text$0.0210
env/v1/env/reset$0.0210
audit/v1/audit$2.001
certify/v1/certify$0.013
watch/v1/x402/watch$0.02—

Records

/v1/verify/{record_sha256}GETre-check a record by its sha256: the seal recomputed and the signature checked; `?file=<sha256>` asks whether a downloaded file is one of a build record's outputs
/v1/verifyPOSTre-check a record you hold, posted as JSON
/v1/badge/{record_sha256}.svgGETa badge for a record, for a README
/.well-known/assay.jsonGETthe issuer: its key and the Assay standard's version
/assay/standardGETthe Assay standard, the record format every answer is sealed in

The tools' companions

/v1/score/formsGETthe forms score can measure a text against
/v1/assert/checksGETthe checks assert can run
/v1/x402/inspect/checksGETthe checks inspect runs on an endpoint
/v1/diff/checksGETthe comparisons diff can make
/v1/extract_text/languagesGETthe languages extract reads
/v1/envGETthe environments an episode can be played in
/v1/env/stepGET POSTone step of a running episode
/v1/env/episode/{episode_id}GETa sealed episode, by its id
/v1/env/tape/{record_sha256}GETa sealed episode as a tape: seed, level, actions and every ply's state digest, for a core at core_sha to replay and compare (free)
/v1/env/scorecardPOSTa scorecard sealed over episodes
/v1/audit/{job}GETan audit's result, fetched again
/v1/audit/sample-graderPOSTthe sample grader an audit can be tried on, free
/v1/x402/watch/{host}GETa watched endpoint's page of results
/v1/badge/x402/{host}.svgGETa watched endpoint's badge

The house

/healthGETthe service's own checks (house database, store, disk, rooms); 503 when down
/v1/versionGETthe release that is running
/v1/releasesGETevery release, newest first (also /changelog and /changelog.atom)
/changelogGETwhat changed, as a page
/changelog.atomGETwhat changed, as a feed
/charterGETthe charter the service runs under (also /.well-known/charter.md)
/.well-known/charter.mdGETthe charter
/.well-known/proceedings.jsonGETtoday's proceedings: each day's counts, signed
/.well-known/proceedings/{day}.jsonGETa day's proceedings
/.well-known/security.txtGETwhere to report a flaw (once the contact is published)

Agents and discovery

/mcpPOSTthe MCP server (streamable HTTP): every tool, paid by key, by x402 or within the free calls
/mcp/directoryGET POST DELETEthe same server, as listed in Claude's connectors directory: no payment tools
/.well-known/x402GETthe x402 manifest: every paid route and its price (404 while sales are paused)
/v1/modelsGETcertify as an OpenAI-compatible model listing
/v1/chat/completionsPOSTcertify through the OpenAI chat shape

Accounts, pages and the issuer

/v1/credits/buyPOSTa card pack: Stripe Checkout, a key minted when it is paid (503 while sales are paused)
/.well-known/openid-configurationGETthe s2ar identity's issuer (id.s2ar.dev)
/.well-known/jwks.jsonGETthe issuer's public keys
/pages/meGET PUT DELETEyour page at s2ar.dev/@handle, published by an app with your token
/pages/{pid}PUT DELETEa project's page

Reports from the games

/v1/reportsPOSTthe in-game Report: a player's words, sealed and held for the house's triage; no account, rate-limited
/v1/reports/{record_sha256}GETwhere a report stands: the record's essentials and its issue's standing
/reports/{record_sha256}GETthe same, as the page a reporter watches without an account

Errors

Every error is JSON: {"error": {"type": …, "message": …}}.

statustypewhat it means
400 / 422invalid_request, invalid_repo, invalid_ref, image_url, …the call itself is wrong: a parameter out of range, a body that does not match, a URL we will not fetch
401auth_errora key was sent and it is not one of ours
402payment required, insufficient_credit, insufficient_balanceno free call left and no payment: the answer says how to pay (a key, x402's accepts[], or MPP's challenge); while sales are paused it offers no rail and names the pause
404not_foundno such record, job, episode or page
413(the proxy)a body over the cap: 2 MB for JSON, 60 MB for the image routes
429rate_limit_errortoo fast: wait the Retry-After seconds
503temporarily_unavailablea service behind the route is down; nothing was charged