# apis.ax

> The agent-first API catalog — every high-quality API an agent needs mid-task, agent-legible by construction, worst-case cost on the wire before the first call.

apis.ax is an App on **apps.ax** — the multi-tenant interpreter. ONE typed
Listing Definition renders every face — the JSON API, the faceted HTML directory
(human register), and the markdown-of-live-state twin (agent register) — from the
same live state, selected BY HOSTNAME. Facets are derived from the Listing type,
not hand-authored.

## Faces

- [Directory (markdown twin)](https://apis.ax/directory?format=md): the live App state as markdown.
- [Directory (HTML)](https://apis.ax/directory?format=html): the designed, faceted human register.
- [API face](https://apis.ax/api/listings): JSON `{ listings, facets, query? }`; supports `?q=<term>` and `?<facet>=<value>`; paginated via `?limit=` (default 200, max 500), `?offset=`.
- [Listing detail](https://apis.ax/listings/:id): one listing, both registers.

## The noun

```
Listing {
  name: string
  summary: string
  category: reference-data | enrichment | web-access | intelligence | compute | geo | finance | commerce | business | compliance | logistics | platform   # enum → a derived facet
  sources: string
  pricing: string
}
```

## The apis.ax site (agent register: every route below, verbatim markdown)

- [The landing](https://apis.ax/): what to do, keyless, right now.
- [AXP — the Agent eXperience Protocol](https://apis.ax/axp): the seven-clause normative spec.

### The five motions

- [B2A](https://apis.ax/b2a): An agent with a wallet finds an API here, tries it with no key, and buys mid-task — the 402 response names the exact price, and payment settles under a spending cap a human set once.
- [B2H2A](https://apis.ax/b2h2a): A human sets a spending cap once; the fleet works inside it, and when a real decision comes up, a signed approval link lands in chat — approve or decline in one tap.
- [B2A2B](https://apis.ax/b2a2b): Your agent buys from another business on a client's behalf — the client's authorization travels with the request, and your fee sits as a disclosed line on the same priced offer.
- [B2A2C](https://apis.ax/b2a2c): Shop the catalog for a person and hand back a receipt they can read — the URL your agent called opens for them as a designed page of the same result.
- [B2A2D](https://apis.ax/b2a2d): When a call becomes a dependency, pin it — audit the API in CI against the exact contract you tested, so a change fails the build, not production.

### Definitions

- [What is AX? Agent eXperience, defined](https://apis.ax/what-is-agent-experience)
- [The No-ask Zone — first value before the first ask](https://apis.ax/first-value)
- [Typed outcomes — the five-kind algebra every call resolves to](https://apis.ax/typed-outcomes)
- [The Handoff — pull your human in at exactly the decision point](https://apis.ax/handoff)
- [Agent-led commerce — the five motions](https://apis.ax/agent-led-commerce)
- [Optimize for the reader you actually have](https://apis.ax/manifesto)