OIoilpriceapi
Drilling Intelligence
Premium

List state drilling permits

Changed on

Paginated drilling permits from state regulators, newest permit_date first. Each row carries the permit, operator, well, location, target and source provenance.

Requires a Well Permits subscription (an add-on or the Scale plan). Free keys can use the bounded /v1/ei/well-permits/preview instead.

get/v1/ei/well-permits

Request

Query parameters

statesstring
Example:TX,NM

Comma-separated two-letter state codes. Unsupported codes are ignored. Omit for every covered state.

start_datestring date
Example:2026-10-01

Earliest permit_date to include (ISO date).

end_datestring date
Example:2026-11-06

Latest permit_date to include (ISO date).

pageinteger
Example:1

One-based page number.

per_pageinteger
Example:25

Rows per page. Values above 100 are reduced to 100.

Response

One page of well permits

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"
        }
      }
    ],
    "meta": {
      "total_count": 2332367,
      "page": 1,
      "per_page": 25,
      "total_pages": 93295
    }
  }
}

Changes