● LIVE NOWLos Angeles County power outage: what to do while the power is…Las Vegas storm warning: what to do and who to callIndia cyclone: how to prepare, where to shelter, who to callAll live stories & alerts →
· Not an emergency service. In an emergency, call 911. PlansDashboardAPI & MCPStore
Sign up free and get more. Alerts for your area when something happens, your city's public record every Monday, and 10% off every SOS.city guide.Sign up free: local alerts, a weekly city record and 10% off the guides.
THE PUBLIC RECORD · ORGANISED · SOS.CITY · SOS.city Get alerts
Data store

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:

WhatCreditsPricePerHow to ask for it
Records past your plan's history window (Free: 30 days)1$0.01per querysearch_records full_history=true · GET /v1/records?full_history=1
More than 100 rows in one records query (up to 1,000)1$0.01per 100 rows past the first 100search_records limit · GET /v1/records?limit=1000
Calls past your plan's allowance1$0.01per callany endpoint
City data pack: every source that covers one place, plus a year of records whose sources allow reuse, as JSON or CSV2,900$29per placeget_city_pack · GET /v1/store/packs/{place}
Building record: permits, code cases, inspections and certificates of occupancy on file for one Los Angeles address900$9per addressGET /v1/store/building-record?address=…&zip=…
Deep search: a researched answer when the library has a gap—from $29questionAsk for a quote · POST /v1/requests kind=deep_search
Credit pack$101,000 credits
Credit pack$7910,000 credits (21% off)
Monthly plansFrom $9More questions, API calls, history and the expired-records archive.Compare plans

How paying works

1 · Credits by cardFor people, teams and agents
  1. Pick a pack below, or an agent calls buy.
  2. The person who pays checks out on Stripe.
  3. A new buyer claims an API key once, from the link after payment.
  4. Paid calls take credits from the key: Authorization: Bearer.
2 · x402 pay-per-callFor autonomous agents
  1. Call a paid URL. It answers 402 with PAYMENT-REQUIRED: price, USDC on Base, where to pay.
  2. Retry with PAYMENT-SIGNATURE.
  3. We verify, produce the data, then settle through Coinbase's facilitator.
  4. You get the data and PAYMENT-RESPONSE. No account, no key.
3 · OutrightOne place, one address

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 address

How to read a charge

  • Every paid response says what it cost. X-SOS-Credits-Used and X-SOS-Credits-Left come back on each call paid with credits; x402 calls return the settlement in PAYMENT-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

Card details go to Stripe, never to us.

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.

Sources