# filings.legal — one agent-native endpoint for every government filing

filings.legal is the demand surface for a single verb: FILE. An agent POSTs a
filing; the endpoint answers with a typed response it can branch on and a price
it can drop into a cost function. Billing is metered on the government receipt
(the ProofPredicate): no filing, no charge — no state in the machine ever holds
an unearned fee.

## What files today, and what is only described

The one OPEN filing act sold today is the pro-se provisional patent filing:
$199 flat, released only on the USPTO receipt, no credential and no signature
required (an applicant may file their own). Status reads are keyless.

The RESERVED filings — utility patents, patent office-action responses,
trademark office-action responses — are DESCRIBED, never sold. Each returns a
typed PENDING_SIGNER: the credential the act requires, a sovereign refusal
stating that an agent cannot sign it, the independent professional it routes to
(through gigs.lawyer), and NO ship date. filings.legal will not forge a
signature and never implies an agent can sign a reserved filing.

## Typed states

- ACCEPTED — an open filing accepted and tracked; Meter present, unreleased.
- PENDING_SIGNER — a reserved filing routed to a licensed human; refusal final.
- OK | EMPTY | BLOCKED — the AXP list envelopes on /filings.

## Quickstart

```sh
npx filings.legal
curl https://filings.legal/filings          # keyless — a typed OK envelope
curl https://filings.legal/pricing          # the Pricing Document ({"model":"free"})
curl https://filings.legal/healthz          # liveness, typed
```

Preview build: in-memory demo state on the substrate, no live filings. Nothing
here is legal advice.

## Machine surfaces

- Capability card (AXP probe manifest): https://filings.legal/.well-known/agents.json
- OpenAPI 3.1 contract: https://filings.legal/openapi.json
- Pricing Document: https://filings.legal/pricing
- This file: https://filings.legal/llms.txt
- The whole substrate catalog: https://api.lawyer
- The signers who sign reserved filings: https://gigs.lawyer