● 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
Datasets

The data you get when you connect

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.

What it is

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.

DatasetkindPublisherCoversRead
Building permitspermitLos Angeles Department of Building and Safety (LADBS)City of Los AngelesRead from the City's open data several times a day
Code-enforcement casescode_caseLADBSCity of Los AngelesEvery two hours
Building inspectionsinspectionLADBSCity of Los AngelesHourly; the feed keeps the last 45 days
Certificates of occupancycofoLADBSCity of Los AngelesEvery three hours
New business registrationsbusinessLos Angeles Office of FinanceCity of Los AngelesEvery six hours
State grantsgrantCalifornia Grants PortalCaliforniaEvery six hours
Weather alertsweather_alertUS National Weather ServiceLos Angeles and San Diego countiesHourly
EarthquakesearthquakeUS Geological SurveyWithin 150 km of Los Angeles or San Diego, magnitude 3 and upHourly
Wildfires NewwildfireNational Interagency Fire Center (WFIGS)United StatesHourly
Power shutoffs (PSPS) Newpower_shutoffSouthern California EdisonSCE territory, by countyHourly once switched on
Fire detections from orbit Newfire_detectionNASA FIRMS (VIIRS on NOAA-20 and NOAA-21)United StatesHourly, within about 3 hours of the satellite pass
Night lights down (power-loss estimate) Newlights_dropNASA Black Marble (VNP46A2), county estimates by SOS.cityContiguous US and Hawaii, by countyNightly; 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

titlePermit type and sub-type
statusIssued, finaled, expired and so on
event_dateDate of the latest status
address, zip, areaJob address, ZIP and neighbourhood council
amountValuation in dollars
unitsDwelling units added or removed

Good for: Who is building what, where, and for how much. Expired permits move to the archive.

https://api.sos.city/v1/records?kind=permit&limit=25

Credit: Source: Los Angeles Department of Building and Safety (LADBS) (https://data.lacity.org/d/pi9x-tg5x)

The original dataset ↗
City of Los AngelesCode-enforcement cases

LADBS · Every two hours

title, categoryCase type (general, pro-active, nuisance abatement and others)
statusOpen until the site complies
event_dateDate the case was opened
address, zip, areaAddress, ZIP and area planning commission

Good for: Buildings the City is inspecting for building, electrical, mechanical or zoning violations, and where cases are rising.

https://api.sos.city/v1/records?kind=code_case&limit=25

Credit: Source: LADBS (https://data.lacity.org/d/u82d-eh7z)

The original dataset ↗
City of Los AngelesBuilding inspections

LADBS · Hourly; the feed keeps the last 45 days

title, categoryInspection type
statusResult (approved, corrections, not ready and so on)
event_dateInspection date
addressJob address

Good for: What inspectors passed or flagged this week at an address.

https://api.sos.city/v1/records?kind=inspection&limit=25

Credit: Source: LADBS (https://data.lacity.org/d/9w5z-rg2h)

The original dataset ↗
City of Los AngelesCertificates of occupancy

LADBS · Every three hours

title, categoryPermit type and sub-type behind the certificate
statusLatest status
event_dateStatus or issue date
address, zipBuilding address
amountValuation in dollars
unitsResidential dwelling units

Good for: New buildings about to open or lease up, with their unit counts.

https://api.sos.city/v1/records?kind=cofo&limit=25

Credit: Source: LADBS (https://data.lacity.org/d/3f9m-afei)

The original dataset ↗
City of Los AngelesNew business registrations

Los Angeles Office of Finance · Every six hours

titleBusiness name (companies only; a sole proprietor's name is never shown)
categoryNAICS industry code
event_dateLocation start date
address, zip, areaAddress for companies, ZIP and council district

Good for: New companies by industry and area, such as new property-management firms.

https://api.sos.city/v1/records?kind=business&limit=25

Credit: Source: Los Angeles Office of Finance (https://data.lacity.org/d/6rrh-rzua)

The original dataset ↗
CaliforniaState grants

California Grants Portal · Every six hours

titleGrant title
categoryCategories
statusActive, forecasted or closed
areaWho can apply
event_date, ends_atOpen date and application deadline
amountEstimated available funds in dollars

Good for: Funding open now, who can apply, and the deadline.

https://api.sos.city/v1/records?kind=grant&limit=25

Credit: Source: California Grants Portal (https://www.grants.ca.gov/)

The original dataset ↗
Los Angeles and San Diego countiesWeather alerts

US National Weather Service · Hourly

title, categoryAlert type (Red Flag Warning, Coastal Flood Advisory and others)
statusSeverity
areaZones covered
event_date, ends_atOnset and end

Good for: Fire weather, flood, heat and wind alerts the moment the Weather Service issues them.

https://api.sos.city/v1/records?kind=weather_alert&limit=25

Credit: Source: US National Weather Service (https://api.weather.gov/)

The original dataset ↗
Within 150 km of Los Angeles or San Diego, magnitude 3 and upEarthquakes

US Geological Survey · Hourly

titleMagnitude and location
event_dateDate
amountMagnitude × 10
urlThe USGS event page

Good for: Felt quakes near the two cities. The data desk pages cover magnitude 2.5 and up for 30 cities.

https://api.sos.city/v1/records?kind=earthquake&limit=25

Credit: Source: US Geological Survey (https://earthquake.usgs.gov/earthquakes/feed/v1.0/geojson.php)

The original dataset ↗
United StatesWildfires

National Interagency Fire Center (WFIGS) · Hourly

titleFire name, county and state
statusPercent contained, or "containment not reported"
categoryWildfire or prescribed burn
event_dateDiscovery date
amountAcres

Good for: Is there a fire near me, how big is it and how contained.

https://api.sos.city/v1/records?kind=wildfire&limit=25

Credit: Source: National Interagency Fire Center (WFIGS) (https://data-nifc.opendata.arcgis.com/datasets/nifc::wfigs-current-interagency-fire-perimeters/about)

The original dataset ↗
SCE territory, by countyPower shutoffs (PSPS)

Southern California Edison · Hourly once switched on

titleCustomers shut off or being considered, and the county
categorycurrent or considered
event_dateDay
unitsCustomers

Good for: Will my power go out. SCE counts customers by county circuit, so a circuit that crosses counties counts in each.

https://api.sos.city/v1/records?kind=power_shutoff&limit=25

Credit: Source: Southern California Edison (https://www.sce.com/outages-safety/outage-preparedness/outage-types/public-safety-power-shutoff-psps)

The original dataset ↗
United StatesFire detections from orbit

NASA FIRMS (VIIRS on NOAA-20 and NOAA-21) · Hourly, within about 3 hours of the satellite pass

titleFire detected from orbit, and the satellite
categoryConfidence: nominal or high (low is dropped)
statusday or night pass
event_dateDay of the pass (UTC)
amountFire radiative power, megawatts

Good for: Where the satellites saw heat. A detection is a hot 375 m pixel, not a confirmed wildfire: flares, plants and burns show too.

https://api.sos.city/v1/records?kind=fire_detection&limit=25

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

titleNight lights down X% in a county (satellite estimate)
statusestimate
event_dateThe night measured
amountChange in light, percent
unitsLit 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.

https://api.sos.city/v1/records?kind=lights_drop&limit=25

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.

The original dataset ↗

Beyond records

DataRESTMCPWhat you get
The libraryGET /v1/search · /v1/sources · /v1/sources/{id} · /v1/places · /v1/departments · /v1/gapssearch_library · get_source · list_places · list_departments · list_gapsEvery 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 statusGET /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 deskGET /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).
RequestsPOST /v1/requestsrequest_recordAsk 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.

What to do next

Questions people ask

Where does the data come from?

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.

Sources