headless.design API
Agent-native cold-reads for landing pages. Free scan + paid 72h deep-pass.
Start here
- GET /v1 self-describing index
- GET /llms.txt for LLM crawlers
- GET /v1/openapi.json OpenAPI 3.1 spec
- GET /.well-known/agent-card.json A2A v0.3.0 agent card
- GET /v1/manifest the human manifest
The product — agent-native (V2)
Canonical paths for agent-native usage. Operator reviews each order before billing, so the agent gets no pay_url at creation — it materializes only when status flips to billing_pending.
-
POST
/v1/scanfree, 3-agent review, ~15s -
POST
/v1/cold-read-requestspaid, creates Order in submitted -
GET
/v1/orders/{id}poll Order — pay_url shows at billing_pending -
POST
/v1/cold-read/{id}/rescanone-shot follow-up after ship
Legacy (V1, sunset 2026-06-25)
Browser fast-pay — mints an invoice immediately and returns pay_url in the 201 response. Used by the marketing site CTA. Agents should use V2 above.
-
POST
/v1/cold-read/requestpaid, 3 900 SEK, V1 fast-pay -
GET
/v1/cold-read/{id}V1 status poll
Human-handoff convention
Agents cannot complete payment. When an order reaches billing_pending, GET /v1/orders/{id} sets a2a_task_state: "input-required" and a pay_url appears — relay it to the human buyer. The convention is declared machine-readably in the agent-card capability extension:
-
URI
https://api.headless.design/extensions/human-handoff/v1A2A capability extension