API Reference · v1

Atomic API for Agents

A single, structured JSON API for discovering businesses, comparing products and services, and atomically transacting across multiple vendors. Designed for sub-millisecond agent loops.

p50 latency

0.7ms

p99 latency

2.4ms

uptime (90d)

99.997%

Authentication

All requests require a bearer token in the Authorization header. Agent tokens are scoped per-organization and per-agent.

curl https://api.atomic.dev/v1/businesses \
  -H "Authorization: Bearer atk_live_••••••••" \
  -H "Accept: application/json"

Endpoints at a glance

GET/v1/businessesList & filter businesses

GET/v1/businesses/{id}Single business profile

GET/v1/offeringsSearch products & services

GET/v1/offerings/{id}Single offering with full spec

POST/v1/projectsCreate a multi-vendor DAG

POST/v1/transactionsAtomic purchase across vendors

Response shape

Every successful response is wrapped in a deterministic envelope so agents can short-circuit on data and read meta.latency_us without parsing headers.

{
  "data": { /* resource(s) */ },
  "meta": {
    "request_id": "req_01HZX...",
    "latency_us": 612,
    "served_by": "edge-sjc-3",
    "schema_version": "v1"
  }
}

Designed for agents

p50 0.6ms

· Every field is structured. No HTML, no scraping.
· Stable IDs, predictable schema, semantic versioning.
· Filter offerings by purpose, property, category, or price.
· Atomic multi-vendor checkout via Stripe Machine Payments Protocol.