Public-records data by the call, the credit or the city
The library is free. Pay only for more history, bigger pulls, a whole city at once, a building record, or a record nobody has published yet. People pay by card. AI agents can also pay per call in USDC with x402.
What you can buy
One credit is one cent. Free covers the library, places, gaps, requests, and records from the last 30 days, 100 rows at a time. These cost extra:
| What | Credits | Price | Per | How to ask for it |
|---|---|---|---|---|
| Records past your plan's history window (Free: 30 days) | 1 | $0.01 | per query | search_records full_history=true · GET /v1/records?full_history=1 |
| More than 100 rows in one records query (up to 1,000) | 1 | $0.01 | per 100 rows past the first 100 | search_records limit · GET /v1/records?limit=1000 |
| Calls past your plan's allowance | 1 | $0.01 | per call | any endpoint |
| City data pack: every source that covers one place, plus a year of records whose sources allow reuse, as JSON or CSV | 2,900 | $29 | per place | get_city_pack · GET /v1/store/packs/{place} |
| Building record: permits, code cases, inspections and certificates of occupancy on file for one Los Angeles address | 900 | $9 | per address | GET /v1/store/building-record?address=…&zip=… |
| Deep search: a researched answer when the library has a gap | — | from $29 | question | Ask for a quote · POST /v1/requests kind=deep_search |
How paying works
- Pick a pack below, or an agent calls
buy. - The person who pays checks out on Stripe.
- A new buyer claims an API key once, from the link after payment.
- Paid calls take credits from the key:
Authorization: Bearer.
- Call a paid URL. It answers 402 with
PAYMENT-REQUIRED: price, USDC on Base, where to pay. - Retry with
PAYMENT-SIGNATURE. - We verify, produce the data, then settle through Coinbase's facilitator.
- You get the data and
PAYMENT-RESPONSE. No account, no key.
A city data pack ($29) or a Los Angeles building record ($9) can be bought on its own, by card, without a plan.
Check an addressHow to read a charge
- Every paid response says what it cost.
X-SOS-Credits-UsedandX-SOS-Credits-Leftcome back on each call paid with credits; x402 calls return the settlement inPAYMENT-RESPONSE. - Failed requests cost nothing. Credits are refunded when a request fails, and an x402 payment isn't settled until the data is ready.
- A payment works once. An x402 transaction can't be reused for a second call.
- Every order keeps your agreement to the data-use terms, with the date.
Buy credits or a city pack
What to do next
Questions people ask
Is SOS.city free?
Yes for people: the library, places, gaps, tools, guides, alerts and records within your plan's history (30 days on Free) and 100 rows a query. You pay only for more history, bigger pulls, a whole city at once, a building record or a deep search.
What is a credit?
One credit is one cent. Credits come in packs: $10 for 1,000, or $79 for 10,000. Each paid use costs a fixed number of credits, shown on this page and returned by the API in X-SOS-Credits-Used.
Am I charged when a request fails?
No. If a paid request fails, the credits are refunded at once, and an x402 payment is never settled.
Can an AI agent pay by itself?
Yes, two ways. With x402 it pays per call in USDC on Base, with no account. With credits, the agent asks for a checkout link (the buy tool), a person pays once on Stripe, and the agent then spends from the key.
What can't I use the data for?
Screening tenants, employees, borrowers or insured people, or locating or profiling anyone. SOS.city is not a consumer reporting agency, and every order records your agreement to these terms.
What is in a city data pack?
Every source in the library that covers the place (with publisher, links, licence and check status), plus up to a year of records from feeds whose licence allows reuse. Records whose sources only allow linking are left out.