bash
# Search wells in the Permian Basin
$ curl -H "Authorization: Bearer sk_sondio_..." \
  api.sondio.io/api/v1/wells?basin=permian&limit=3
 
{ "wells": [...], "pagination": { "total": 284791 } }
 
# Get production for a specific well
$ sondio query wells --state TX --operator "EOG" --format json
Found 22,157 wells. Exporting...

Oil & gas data API

REST API with 45 endpoints. Wells, production, permits, incidents, pipeline data, and more. Built on PostGIS, served from the edge.

45 endpoints, one key

Consistent JSON responses, cursor pagination, Bearer auth. OpenAPI 3.0 spec included.

GET/api/v1/wellsSearch 1.8M wells
GET/api/v1/wells/:idWell detail + production
GET/api/v1/wells/:id/nearbyPostGIS proximity
GET/api/v1/productionMonthly volumes
GET/api/v1/permitsDrilling permits
GET/api/v1/incidentsViolations & spills
GET/api/v1/operatorsOperator profiles
GET/api/v1/pipeline-incidentsPHMSA data
GET/api/v1/map/clustersH3 hex bins
GET/api/v1/countiesCounty aggregation
POST/api/v1/datasets/:slug/uploadUpload data
GET/api/v1/activityChange feed
REST API

JSON everywhere

Standard REST with query params. Paginated responses, consistent error format, CORS enabled.

CLI

sondio query

npm package for terminal workflows. Query, export CSV, upload data. Pipe to jq or your scripts.

MCP

AI-native

Streamable HTTP MCP server. 6 tools for Claude, ChatGPT, or any MCP-compatible agent.

OpenAPI

Spec-driven

3,000+ line OpenAPI 3.0 spec. Generate client SDKs in any language. Postman collection ready.

PostGIS

Spatial queries

Nearby wells, H3 hex clustering, bounding box filters, pipeline route geometry. Real GIS, not geocoding.

Edge

Fast globally

Cloudflare Workers at the edge. PostgreSQL via Hyperdrive. Sub-100ms for cached endpoints.

Start building

Free tier: 100 API calls/month. All endpoints. No credit card.

Read the docs Get API key