OIoilpriceapi
Drilling Intelligence

Get well permits data

Changed on

Get recent drilling permits with bounded pagination and an optional state filter. Requires the Scale plan.

get/v1/drilling-intelligence/well-permits

Request

  • Base URL
    https://api.oilpriceapi.com
  • Auth
    API key in header Authorization

Query parameters

state_codestring
Example:TX

Two-letter US state code

daysinteger
Example:30

Lookback window in days (clamped to 1-365)

pageinteger
Example:1

Page number for pagination

per_pageinteger
Example:50

Results per page (max 200)

Response

Well permits data

statusstring required

Example response

{
  "status": "success",
  "data": {
    "well_permits": [
      {
        "state": "TX"
      }
    ]
  }
}

Changes

  • 5a5ce424caccRevision changes
    • breaking

      for the query request parameter per_page, default value was changed from 100 to 50

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the new optional query request parameter days

    • info

      added the new optional query request parameter state_code

    • info

      for the query request parameter per_page, the max was increased from 100.00 to 200.00

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status