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.
What the SOS.city API and MCP server return: live records read from the agencies that publish them, the library of official sources, internet and power status, and the data desk. Every row names its publisher and links to the original.
SOS.city reads official open data on a schedule, keeps one row per record, and serves it the same way for every dataset. Ask with GET https://api.sos.city/v1/records?kind=… or the MCP tool search_records, filtered by place, ZIP, street address or date.
NASA Black Marble (VNP46A2), county estimates by SOS.city
Contiguous US and Hawaii, by county
Nightly; NASA's data runs about a week behind
How every row is built
Each record comes back with the same columns: id, kind, title, category, status, address, zip, area, event_date, ends_at, amount, units, url, place, source_id, publisher, source_url, licence, credit. url is the agency's original; publisher and source_id lead to the library entry with its licence and check status. credit is the acknowledgment the publisher asks for: quote it with anything you publish from a record. What each column means depends on the dataset:
City of Los AngelesBuilding permits
Los Angeles Department of Building and Safety (LADBS) · Read from the City's open data several times a day
title
Permit type and sub-type
status
Issued, finaled, expired and so on
event_date
Date of the latest status
address, zip, area
Job address, ZIP and neighbourhood council
amount
Valuation in dollars
units
Dwelling units added or removed
Good for: Who is building what, where, and for how much. Expired permits move to the archive.
Credit: Source: National Interagency Fire Center (WFIGS) (https://data-nifc.opendata.arcgis.com/datasets/nifc::wfigs-current-interagency-fire-perimeters/about)
Credit: We acknowledge the use of data and/or imagery from NASA's Fire Information for Resource Management System (FIRMS) (https://earthdata.nasa.gov/firms), part of NASA's Earth Science Data and Information System (ESDIS). FIRMS data are provided "as is".
The original dataset ↗Contiguous US and Hawaii, by countyNight lights down (power-loss estimate)
NASA Black Marble (VNP46A2), county estimates by SOS.city · Nightly; NASA's data runs about a week behind
title
Night lights down X% in a county (satellite estimate)
status
estimate
event_date
The night measured
amount
Change in light, percent
units
Lit pixels measured
Good for: How far the lights went down after a storm or fire, confirmed over two nights. A satellite estimate, not a utility outage report: clouds, snow and the moon can move it.
Credit: Night-light data: NASA Black Marble VNP46A2, acquired from the Level-1 & Atmosphere Archive and Distribution System (LAADS) Distributed Active Archive Center (DAAC), https://ladsweb.modaps.eosdis.nasa.gov/. County estimates computed by SOS.city.
Every official source: record, publisher, place, department, original link, API endpoint, format, update rate, licence and reuse status, and whether we opened and checked it. Plus the places, the 15 departments and the gap board.
Internet and power status
GET /v1/grid/status · /v1/grid/cities
—
The state of key internet and power points (cloud, DNS, cable landings, utilities) and of internet service in every library city, refreshed every 15 minutes from the operators' own status pages.
Data desk
GET /v1/data · /v1/data/report?place=&report=
—
Recurring reports for the 30 largest US cities: gas prices (EIA), inflation (BLS), drought (US Drought Monitor), earthquakes (USGS) and, in California, ambulance offload waits (EMSA).
Requests
POST /v1/requests
request_record
Ask for a record we don't have. It goes on the gap board; a deep search is quoted before you pay.
How to read it
The original wins. If a record here differs from the agency's page, the agency is right. Every row links there.
Free shows 30 days and 100 rows. Ask for full_history or a bigger limit and it's paid from credits (prices).
Dates are the record's own.event_date is when the agency says it happened, not when we read it.
Gaps are listed, not filled. If something isn't covered it's on the gap board, never invented.
From the agencies that publish it: the City of Los Angeles open data portal, the California Grants Portal, the National Weather Service, the USGS, the National Interagency Fire Center and Southern California Edison. Every row links to the agency's original.
How fresh is it?
Each dataset lists how often it's read. Most are read hourly or every few hours; the agency's own update schedule sets the limit.
Is there personal information?
No. Records are about buildings, places and events. Sole proprietors' names and addresses are never shown, and there is no search by person.
How far back does it go?
Free returns the last 30 days. Paid history goes back as far as SOS.city has read each feed; a building record looks one address up straight from the City's own records.
Can I get it as a file?
Yes. A city data pack downloads every source and up to a year of reusable records for one place as JSON or CSV.