OIoilpriceapi
Drilling Intelligence

Preview recent drilling permits for one state

Changed on

Bounded preview of real permit data that any API key can call, including Free. It returns at most 25 permits from the trailing 90 days for one state, newest first. Pagination is not supported; the row cap is the bound.

meta reports the data's freshness (as_of, data_age_days, stale) and per-state date coverage. For full history, every state, and operator, formation or geographic search, use /v1/ei/well-permits with a Well Permits subscription.

get/v1/ei/well-permits/preview

Request

Query parameters

statestring
Example:TX

Two-letter state code. Defaults to TX.

daysinteger
Example:30

Trailing window in days, clamped to 1-90.

Response

Up to 25 recent permits for the state

statusstring required

Example response

{
  "status": "success",
  "data": {
    "well_permits": [
      {
        "api_number": "42501377100000",
        "state_code": "TX",
        "county": "Yoakum",
        "permit_type": "new_drill",
        "permit_status": "approved",
        "permit_date": "2026-11-06",
        "well": {
          "type": "oil"
        },
        "location": {
          "latitude": "33.1247065",
          "longitude": "-102.9828543"
        },
        "target": {
          "total_depth_proposed": 7000
        },
        "provenance": {
          "source": "texas_rrc"
        }
      }
    ],
    "preview": true,
    "meta": {
      "state": "TX",
      "days": 90,
      "count": 25,
      "row_cap": 25,
      "bounded": true,
      "as_of": "2026-11-06",
      "data_age_days": 3,
      "as_of_basis": "max(permit_date)"
    }
  }
}

Changes