SOS.city public record

Starts a one-time purchase and returns a Stripe Checkout link for the person who pays, plus a status_url to poll. product: credits_1k ($10), credits_10k ($79), city_pack ($29, needs place) or compliance_list ($99, one whole compliance list as CSV, needs list). The person must agree to the data-use terms (no screening or profiling people): pass agree_data_use=true only after they have.

Every bank and credit union with a branch in one county, with branch counts and assets. 25 credits from the API key (free with a watch for that state). Organizations only.

Free. How many bank and credit union branches a ZIP, county or state has today, how far the nearest bank branch is, closings and openings in the last 120 days, ZIPs left with one bank or none, and the top lenders already there. From FDIC BankFind, the NCUA call report and Census files, rebuilt daily. Give zip, county (5-digit FIPS), place (a county or state place id) or state; none gives the US.

Every source that covers one place (with publisher, original link, licence and reuse terms) plus a year of records whose sources allow reuse. Costs 2900 credits from the API key's balance. Without credits, use buy (product city_pack) or the REST URL with x402.

Free. FEMA National Risk Index for the county of one of the 30 largest U.S. cities: overall rating and score, every hazard's share of the risk, rating, score and expected annual loss, plus (for verified cities) the federal disaster declarations and the official emergency alert sign-up. Omit city for the list. Every result names its source; FEMA rates counties, not cities.

Buildings and facilities added to, taken off, or changed on a compliance list since a day (default the last 7 days), from the agency's own data. Counts are free; the first 10 rows are free, then credits per 100 rows. Off the list means the agency's data no longer lists the item, not proof the work was done.

Rows of one compliance list (address, ZIP, dates, status, the agency's id, a link to the original, and other lists the same address is on). The first 10 rows are free; more cost credits per 100 rows (see get_store). Filter by zip, address (q), status, type, since (YYYY-MM-DD) or stacked=true (addresses on more than one list).

Full details of one source by id: publisher, original link, API endpoint, formats, update rate, last update, licence, location detail, check status and notes.

The SOS.city data store: what's free, what costs credits (1 credit = 1 cent), credit packs, city data packs, building records and deep searches, and every way to pay (credits with an API key, x402 USDC, or a Stripe link for a person). Shows the caller's credit balance when an API key is sent.

ZIPs where a branch closing left no bank, one bank, or a 10+ mile trip to the next branch, with the bank that left and the nearest one still open. Free: the last 30 days, 25 rows. full=true returns the whole 120-day window (100 credits from the API key, or free with a watch for that state).

Buildings and facilities that owe a legally required inspection, filing or fix (SB 721 balcony inspections, LA energy benchmarking, open code cases, soft-story and concrete retrofits, industrial stormwater permits), read from the agency's dataset and refreshed daily. Free: what each law requires, who may sign, how many are on each list, by ZIP and status. For the firms that do this work. Not for finding or profiling people.

The account's compliance watches: what each covers, how it's delivered, when it last went out and what it did, and its tracked items open and closed.

The 15 departments (shelves) every source sits on, with what each covers.

Records people need that the library doesn't hold yet, or that no agency publishes. Check this before telling a user a record doesn't exist.

The atlas: world, countries, states, counties and cities, with their ids. Filter by parent id (e.g. 'us' for US states) or kind.

Start a checkout for a Bank desert watch (state, regional, national, closing soon, branch sites) or a one-time report (market brief, acquisition screen, merger impact). Returns a Stripe link for the person who pays. See get_store for prices.

Ask SOS.city to find a public record that isn't in the library. It joins the gap board; give an email to hear back. Never for locating or profiling a person.

Find public-records sources (datasets, portals, registers, reports) by question or keywords. Use `place` to include everything covering a place, from the city up to federal and global sources. Returns the publisher, how to get the data (API endpoint or page), update rate, last update, licence and whether we verified it. Not for finding, profiling or screening people.

The records SOS.city reads from agencies' open data, one row each: building permits, code-enforcement cases, inspections, certificates of occupancy, new business registrations, grants, weather alerts, earthquakes, US wildfires (NIFC), SCE power shutoffs, satellite fire detections (NASA FIRMS), bank branch openings, closings and mergers (FDIC), current drug shortages (openFDA) and county night-light drops that estimate power outages (NASA Black Marble). Filter by place, kind, ZIP or street address. Each row links to the agency's original. History depends on the plan (Free: 30 days, 100 rows). full_history=true (1 credit) and limit over 100 (1 credit per extra 100 rows, up to 1,000) are paid from the API key's credits; see get_store.

Save a watch on one compliance list (ZIPs, status, type, stacked) and get what changed daily or weekly by email and/or a signed webhook. Pass track (item keys) to follow items one by one: each closes on its own when the agency's data no longer lists it. Needs an API key. Rows past the first 10 in each delivery cost credits per 100.