{ "openapi": "3.0.3", "info": { "title": "TankScreen - US Storage Tank & Leaking Tank (UST/LUST) API", "description": "US underground and aboveground storage tank (UST/AST) registrations and leaking-tank (LUST) release cases, pulled directly from state environmental agencies and normalized into one API. Built for environmental due diligence: screen a property for nearby tanks and open contamination cases before a deal closes, instead of ordering a report. Each record carries the facility name, address, city, county, state, substance, a canonical status (in_use, closed, temporarily_out_of_use, pending, open, unknown), report and closure dates, and coordinates. Search a radius around any point with lat, lng and radius_km, or filter by state (a two-letter code such as tx or ca), category (tank or release), status, substance, city and county, and call /storage_tank/coverage and /storage_tank/stats for live per-state counts. Facility records only: no owner or contact names are collected or stored. Data is republished from state environmental agencies; acknowledgment of the Texas Commission on Environmental Quality is made for the Texas data. Per-source attribution is listed at https://tankscreen.us/attribution.", "version": "0.1.0" }, "paths": { "/health": { "get": { "summary": "Health", "operationId": "/health", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/storage_tank": { "get": { "summary": "Search storage tanks and leaking-tank releases", "operationId": "/storage_tank", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Full-text search across data fields. Space-separated words require all terms (e.g. \"wood panel\"). Use OR to match any term (\"wood OR panel OR acoustic\"), quotes for exact phrases (\"supply arrangement\"), and a leading minus to exclude (\"software -hardware\")." }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Procurement category: CNST, GD, SRV, SRVTGD. For recalls: product category (e.g. 'Baby products', 'Toys and games', 'Household items')." }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Filter by status (Active, Expired, Cancelled, Open)" }, { "name": "substance", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Filter by pollutant substance name (release)" }, { "name": "city", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Filter by city. Exact, case-insensitive (liquor, healthcare)." }, { "name": "county", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Filter by county. Exact, case-insensitive (liquor, healthcare)." }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Filter by 2-letter US state code, e.g. FL, CA, TX (healthcare, liquor)." }, { "name": "issued_after", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Filter by report date >= YYYY-MM-DD (reported_date)" }, { "name": "issued_before", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Filter by date <= YYYY-MM-DD" }, { "name": "lat", "in": "query", "required": false, "schema": { "type": "number", "nullable": true }, "description": "Latitude for proximity search" }, { "name": "lng", "in": "query", "required": false, "schema": { "type": "number", "nullable": true }, "description": "Longitude for proximity search" }, { "name": "radius_km", "in": "query", "required": false, "schema": { "type": "number", "maximum": 25.0, "minimum": 0.1, "nullable": true }, "description": "Radius in km (requires lat and lng, max 25)" }, { "name": "sort_by", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Sort field: published (publication_date for tenders, award_date for contracts), date (event date), value (contract/agreement value), closing (closing_date for tenders)" }, { "name": "sort_order", "in": "query", "required": false, "schema": { "type": "string", "description": "Sort order: asc or desc", "default": "desc", "title": "Sort Order" }, "description": "Sort order: asc or desc" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 100, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Pagination cursor from next_cursor in a previous response. Use instead of offset for deep pagination." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/storage_tank/stats": { "get": { "summary": "Storage tank statistics", "operationId": "/storage_tank/stats", "parameters": [ { "name": "group_by", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Data field to group by" }, { "name": "period", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "30d, 90d, 1y, all. Defaults to all for static registries (healthcare, liquor); 30d otherwise." }, { "name": "sum_field", "in": "query", "required": false, "schema": { "type": "string", "nullable": true }, "description": "Data field to sum (e.g. contract_value)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/storage_tank/coverage": { "get": { "summary": "Storage tank count per state", "operationId": "/storage_tank/coverage", "parameters": [], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/storage_tank/{record_id}": { "get": { "summary": "Get storage tank record by ID", "operationId": "/storage_tank/{record_id}", "parameters": [ { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Record Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } } }, "servers": [ { "url": "https://hv1nforwhi.execute-api.ca-central-1.amazonaws.com" } ] }