{"contractVersion":"parcelops.connector.v1","name":"nrc-spills","displayName":"National Response Center (USCG) Spill Reports","description":"Reported oil, chemical, and hazmat spill and release incidents from the U.S. Coast Guard National Response Center, the federal hotline anyone calls to report a release. Search by county and calendar year, summarize what a county saw, pull one report in full, or search the mapped subset around a coordinate. This is the environmental screening layer the EPA facility and enforcement connectors do not cover: it records releases from unregulated callers, trucks, rail, vessels, and neighboring property. Every record is an INITIAL, UNVERIFIED caller report, never a confirmed release and never a cleanup status. This is the Coast Guard spill hotline, not the Nuclear Regulatory Commission.","tags":["nrc-spills","national-response-center","uscg","coast-guard","spill","oil-spill","chemical-release","hazmat","environmental","phase-i","due-diligence","contamination","county"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"U.S. Coast Guard National Response Center (NRC) annual incident reports","sourceUrl":"https://nrc.uscg.mil/FOIAFiles/CY26.xlsx","apiBaseUrl":"https://nrc.uscg.mil/","documentationUrl":"https://nrc.uscg.mil/FOIAFiles/DataDictionary.xlsx"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"asOf","notes":"The current calendar year file is rewritten continuously; it was modified the same day it was probed on 2026-08-10 and carried reports from the previous day. Closed years are republished irregularly, and each file carries its own vintage from its Last-Modified header."}},"coverage":{"geographic":{"status":"declared","value":["United States counties and county equivalents, matched on the county name the National Response Center (USCG) records, populated on about 99 percent of reports","United States offshore lease areas recorded under a coastal state, such as Green Canyon Area and Mississippi Canyon Area in Louisiana","United States territories including Puerto Rico, the U.S. Virgin Islands, Guam, and the Northern Mariana Islands","Some reports in Canada (state code CN) and Mexico (state code MX), which the National Response Center (USCG) also fields"]},"temporal":{"status":"declared","value":{"start":"1990","notes":"One workbook per calendar year from 1990 forward. Files are keyed to the year a report was FILED, not the year the incident happened, so each file carries some reports describing older incidents. The current year is always partial."}}},"methods":{"total":5,"items":[{"name":"searchIncidentsByCounty","description":"Reported spills and releases in one county for one calendar year. The primary screen.","notes":"Pass countyFips, or stateAlpha plus countyName. Zero is a citable zero.","requiredParams":["year"],"inputSchema":{"type":"object","properties":{"year":{"type":"integer","minimum":1990,"description":"Calendar year of the report file, 1990 through the current year. One call reads one year."},"stateAlpha":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Two-letter state code such as TX. Required with countyName. Canada is CN and Mexico is MX."},"countyName":{"type":"string","minLength":2,"maxLength":80,"description":"County name such as \"Harris\". Also accepts offshore lease areas such as \"Green Canyon Area\"."},"countyFips":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit state + county FIPS such as 48201 (Harris County, Texas). Use instead of stateAlpha plus countyName."},"incidentType":{"type":"string","maxLength":40,"description":"Filter to one published type, for example FIXED, PIPELINE, STORAGE TANK, MOBILE, RAILROAD, VESSEL, PLATFORM, UNKNOWN SHEEN. Case-insensitive."},"materialContains":{"type":"string","maxLength":60,"description":"Keep only reports naming a material containing this text, for example \"diesel\" or \"crude\"."},"reachedWaterOnly":{"type":"boolean","description":"Keep only reports where a released material was recorded as reaching water."},"excludePotential":{"type":"boolean","description":"Drop reports flagged as potential rather than observed releases."},"includeMaterials":{"type":"boolean","description":"Include the materials reported released for each report. Defaults to true."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Reports to return. Defaults to 25."},"offset":{"type":"integer","minimum":0,"description":"Reports to skip, for paging."}},"required":["year"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"asOf","notes":"The current year file changes daily; closed years are republished irregularly. The vintage returned is the file's own Last-Modified."},"scope":"method"},"entities":{"status":"declared","value":["spill_report","county","material"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["The National Response Center (USCG) is an emergency call center, not a response agency. These are INITIAL reports made by callers and have not been validated or investigated by any federal or state response agency.","This is not a substitute for a Phase I environmental site assessment. It is one records source a Phase I would consult, and it covers only what was called in to this one federal hotline.","This data carries no cleanup, remediation, enforcement, or case-closure status of any kind. A report never tells you whether anything was cleaned up, or whether the release turned out to be real.","A report is not a confirmed release. It records that somebody called the hotline and what they said at the time.","Reports flagged as potential releases describe a release that might occur or might have occurred, not an observed one.","The responsible party is the SUSPECTED responsible company as recorded by the call taker, in the data dictionary's own wording, and it is named on only about half of reports.","Zero reports means zero for that county, that calendar year, and that file. It is not a finding about the parcel, about earlier or later years, or about releases nobody called in.","Only a minority of reports carry coordinates, and coverage is far worse for onshore fixed facilities than for offshore platforms, so county search sees reports that point-radius search physically cannot. Never use a radius result as the screen.","Coordinates are published as degrees, minutes and seconds by the call taker and describe where the caller said the incident was, not a surveyed location. No coordinate is ever synthesized from an address.","Incident timestamps are published with no timezone anywhere in the file or the data dictionary, so they are returned verbatim rather than converted.","Counts are counts of reports, not of confirmed releases and not of volumes. Two callers reporting one event produce two reports.","The National Response Center (USCG) here is the U.S. Coast Guard spill hotline. It is not the Nuclear Regulatory Commission, which is a separate agency served by the separate nrc connector.","One call covers one calendar year only. A county with zero reports this year may have many in another year."]},{"name":"summarizeCountyIncidents","description":"Report counts for one county-year broken out by incident type, cause, and material.","notes":"Counts reports, never confirmed releases and never volumes.","requiredParams":["year"],"inputSchema":{"type":"object","properties":{"year":{"type":"integer","minimum":1990,"description":"Calendar year of the report file, 1990 through the current year. One call reads one year."},"stateAlpha":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Two-letter state code such as TX. Required with countyName. Canada is CN and Mexico is MX."},"countyName":{"type":"string","minLength":2,"maxLength":80,"description":"County name such as \"Harris\". Also accepts offshore lease areas such as \"Green Canyon Area\"."},"countyFips":{"type":"string","pattern":"^\\d{5}$","description":"Five-digit state + county FIPS such as 48201 (Harris County, Texas). Use instead of stateAlpha plus countyName."}},"required":["year"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"asOf","notes":"Same file and vintage as searchIncidentsByCounty."},"scope":"method"},"entities":{"status":"declared","value":["county","spill_report"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"reports":"reports"}},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["The National Response Center (USCG) is an emergency call center, not a response agency. These are INITIAL reports made by callers and have not been validated or investigated by any federal or state response agency.","This is not a substitute for a Phase I environmental site assessment. It is one records source a Phase I would consult, and it covers only what was called in to this one federal hotline.","This data carries no cleanup, remediation, enforcement, or case-closure status of any kind. A report never tells you whether anything was cleaned up, or whether the release turned out to be real.","A report is not a confirmed release. It records that somebody called the hotline and what they said at the time.","Reports flagged as potential releases describe a release that might occur or might have occurred, not an observed one.","The responsible party is the SUSPECTED responsible company as recorded by the call taker, in the data dictionary's own wording, and it is named on only about half of reports.","Zero reports means zero for that county, that calendar year, and that file. It is not a finding about the parcel, about earlier or later years, or about releases nobody called in.","Only a minority of reports carry coordinates, and coverage is far worse for onshore fixed facilities than for offshore platforms, so county search sees reports that point-radius search physically cannot. Never use a radius result as the screen.","Coordinates are published as degrees, minutes and seconds by the call taker and describe where the caller said the incident was, not a surveyed location. No coordinate is ever synthesized from an address.","Incident timestamps are published with no timezone anywhere in the file or the data dictionary, so they are returned verbatim rather than converted.","Counts are counts of reports, not of confirmed releases and not of volumes. Two callers reporting one event produce two reports.","The National Response Center (USCG) here is the U.S. Coast Guard spill hotline. It is not the Nuclear Regulatory Commission, which is a separate agency served by the separate nrc connector.","Two callers reporting the same event produce two reports, so counts overstate distinct events."]},{"name":"getIncidentDetail","description":"One report in full: materials, suspected responsible party, and reported impact.","notes":"Files are keyed to the year a report was filed, not the incident year.","requiredParams":["year","reportNumber"],"inputSchema":{"type":"object","properties":{"year":{"type":"integer","minimum":1990,"description":"Calendar year of the report file, 1990 through the current year. One call reads one year."},"reportNumber":{"type":"string","pattern":"^\\d{1,12}$","description":"National Response Center (USCG) report number, the numeric SEQNOS carried on every report."}},"required":["year","reportNumber"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"asOf","notes":"Same file and vintage as searchIncidentsByCounty."},"scope":"method"},"entities":{"status":"declared","value":["spill_report","material"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["The National Response Center (USCG) is an emergency call center, not a response agency. These are INITIAL reports made by callers and have not been validated or investigated by any federal or state response agency.","This is not a substitute for a Phase I environmental site assessment. It is one records source a Phase I would consult, and it covers only what was called in to this one federal hotline.","This data carries no cleanup, remediation, enforcement, or case-closure status of any kind. A report never tells you whether anything was cleaned up, or whether the release turned out to be real.","A report is not a confirmed release. It records that somebody called the hotline and what they said at the time.","Reports flagged as potential releases describe a release that might occur or might have occurred, not an observed one.","The responsible party is the SUSPECTED responsible company as recorded by the call taker, in the data dictionary's own wording, and it is named on only about half of reports.","Zero reports means zero for that county, that calendar year, and that file. It is not a finding about the parcel, about earlier or later years, or about releases nobody called in.","Only a minority of reports carry coordinates, and coverage is far worse for onshore fixed facilities than for offshore platforms, so county search sees reports that point-radius search physically cannot. Never use a radius result as the screen.","Coordinates are published as degrees, minutes and seconds by the call taker and describe where the caller said the incident was, not a surveyed location. No coordinate is ever synthesized from an address.","Incident timestamps are published with no timezone anywhere in the file or the data dictionary, so they are returned verbatim rather than converted.","Counts are counts of reports, not of confirmed releases and not of volumes. Two callers reporting one event produce two reports.","The National Response Center (USCG) here is the U.S. Coast Guard spill hotline. It is not the Nuclear Regulatory Commission, which is a separate agency served by the separate nrc connector.","Injury, evacuation, and damage figures are the caller's first estimates. A blank field means nothing was recorded, never zero."]},{"name":"searchIncidentsNearPoint","description":"Reports within a radius of a coordinate. A mapped subset only, never a screen.","notes":"Most reports carry no coordinates. Screen with searchIncidentsByCounty.","requiredParams":["year","latitude","longitude"],"inputSchema":{"type":"object","properties":{"year":{"type":"integer","minimum":1990,"description":"Calendar year of the report file, 1990 through the current year. One call reads one year."},"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusMiles":{"type":"number","minimum":0.1,"maximum":25,"description":"Search radius in miles. Defaults to 1."},"incidentType":{"type":"string","maxLength":40,"description":"Filter to one published type, for example FIXED, PIPELINE, STORAGE TANK, MOBILE, RAILROAD, VESSEL, PLATFORM, UNKNOWN SHEEN. Case-insensitive."},"includeMaterials":{"type":"boolean","description":"Include the materials reported released for each report. Defaults to true."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Reports to return, nearest first. Defaults to 25."}},"required":["year","latitude","longitude"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"asOf","notes":"Same file and vintage as searchIncidentsByCounty."},"scope":"method"},"entities":{"status":"declared","value":["spill_report"]},"pagination":{"status":"declared","value":{"style":"none","limitField":"limit"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"declared","value":{"distanceMiles":"miles"}},"coordinateReferenceSystem":{"status":"declared","value":"EPSG:4326"}},"caveats":["The National Response Center (USCG) is an emergency call center, not a response agency. These are INITIAL reports made by callers and have not been validated or investigated by any federal or state response agency.","This is not a substitute for a Phase I environmental site assessment. It is one records source a Phase I would consult, and it covers only what was called in to this one federal hotline.","This data carries no cleanup, remediation, enforcement, or case-closure status of any kind. A report never tells you whether anything was cleaned up, or whether the release turned out to be real.","A report is not a confirmed release. It records that somebody called the hotline and what they said at the time.","Reports flagged as potential releases describe a release that might occur or might have occurred, not an observed one.","The responsible party is the SUSPECTED responsible company as recorded by the call taker, in the data dictionary's own wording, and it is named on only about half of reports.","Zero reports means zero for that county, that calendar year, and that file. It is not a finding about the parcel, about earlier or later years, or about releases nobody called in.","Only a minority of reports carry coordinates, and coverage is far worse for onshore fixed facilities than for offshore platforms, so county search sees reports that point-radius search physically cannot. Never use a radius result as the screen.","Coordinates are published as degrees, minutes and seconds by the call taker and describe where the caller said the incident was, not a surveyed location. No coordinate is ever synthesized from an address.","Incident timestamps are published with no timezone anywhere in the file or the data dictionary, so they are returned verbatim rather than converted.","Counts are counts of reports, not of confirmed releases and not of volumes. Two callers reporting one event produce two reports.","The National Response Center (USCG) here is the U.S. Coast Guard spill hotline. It is not the Nuclear Regulatory Commission, which is a separate agency served by the separate nrc connector.","This searches ONLY the minority of reports carrying coordinates. Every response states how many reports it could not test at all, and those are not represented in the result whatever it says.","Coordinate coverage is worst for onshore fixed facilities and best for offshore platforms, so a zero here can sit next to a reported release with no coordinates. Screen with searchIncidentsByCounty.","Coordinates are the call taker's degrees, minutes and seconds, not a surveyed location, and none are ever synthesized from an address."]},{"name":"getServiceInfo","description":"Years published, coverage, limits, and what this data cannot answer.","notes":"States plainly that no cleanup status and no query API exist.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"scheduled","cadence":"P1D","updatedAtField":"asOf","notes":"The current calendar year file is rewritten continuously; it was modified the same day it was probed on 2026-08-10 and carried reports from the previous day. Closed years are republished irregularly, and each file carries its own vintage from its Last-Modified header."},"scope":"connector"},"entities":{"status":"declared","value":["dataset"]},"pagination":{"status":"declared","value":{"style":"none"}},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["The National Response Center (USCG) is an emergency call center, not a response agency. These are INITIAL reports made by callers and have not been validated or investigated by any federal or state response agency.","This is not a substitute for a Phase I environmental site assessment. It is one records source a Phase I would consult, and it covers only what was called in to this one federal hotline.","This data carries no cleanup, remediation, enforcement, or case-closure status of any kind. A report never tells you whether anything was cleaned up, or whether the release turned out to be real.","A report is not a confirmed release. It records that somebody called the hotline and what they said at the time.","Reports flagged as potential releases describe a release that might occur or might have occurred, not an observed one.","The responsible party is the SUSPECTED responsible company as recorded by the call taker, in the data dictionary's own wording, and it is named on only about half of reports.","Zero reports means zero for that county, that calendar year, and that file. It is not a finding about the parcel, about earlier or later years, or about releases nobody called in.","Only a minority of reports carry coordinates, and coverage is far worse for onshore fixed facilities than for offshore platforms, so county search sees reports that point-radius search physically cannot. Never use a radius result as the screen.","Coordinates are published as degrees, minutes and seconds by the call taker and describe where the caller said the incident was, not a surveyed location. No coordinate is ever synthesized from an address.","Incident timestamps are published with no timezone anywhere in the file or the data dictionary, so they are returned verbatim rather than converted.","Counts are counts of reports, not of confirmed releases and not of volumes. Two callers reporting one event produce two reports.","The National Response Center (USCG) here is the U.S. Coast Guard spill hotline. It is not the Nuclear Regulatory Commission, which is a separate agency served by the separate nrc connector."]}]},"caveats":["The National Response Center (USCG) is an emergency call center, not a response agency. These are INITIAL reports made by callers and have not been validated or investigated by any federal or state response agency.","This is not a substitute for a Phase I environmental site assessment. It is one records source a Phase I would consult, and it covers only what was called in to this one federal hotline.","This data carries no cleanup, remediation, enforcement, or case-closure status of any kind. A report never tells you whether anything was cleaned up, or whether the release turned out to be real.","A report is not a confirmed release. It records that somebody called the hotline and what they said at the time.","Reports flagged as potential releases describe a release that might occur or might have occurred, not an observed one.","The responsible party is the SUSPECTED responsible company as recorded by the call taker, in the data dictionary's own wording, and it is named on only about half of reports.","Zero reports means zero for that county, that calendar year, and that file. It is not a finding about the parcel, about earlier or later years, or about releases nobody called in.","Only a minority of reports carry coordinates, and coverage is far worse for onshore fixed facilities than for offshore platforms, so county search sees reports that point-radius search physically cannot. Never use a radius result as the screen.","Coordinates are published as degrees, minutes and seconds by the call taker and describe where the caller said the incident was, not a surveyed location. No coordinate is ever synthesized from an address.","Incident timestamps are published with no timezone anywhere in the file or the data dictionary, so they are returned verbatim rather than converted.","Counts are counts of reports, not of confirmed releases and not of volumes. Two callers reporting one event produce two reports.","The National Response Center (USCG) here is the U.S. Coast Guard spill hotline. It is not the Nuclear Regulatory Commission, which is a separate agency served by the separate nrc connector."]}