---
title: "List states with production data"
method: GET
path: "/v1/well-production/states"
tags: ["Well Production"]
---

# List states with production data

`GET /v1/well-production/states`

## Request

- Base URL: `https://api.oilpriceapi.com`
- URL: `https://api.oilpriceapi.com/v1/well-production/states`
- Auth: API key in header `Authorization`

List states with available well-production coverage and their latest available period.

## Query parameters

- `period` string

## Response `200`

States with available production data

- object
  - `status` string
  - `data` object
    - `period` string, nullable
    - `count` integer
    - `states` object[]
      - `state` string
      - `period` string
      - `oil_bbl` number, nullable
      - `oil_bpd` number, nullable
      - `gas_mcf` number, nullable
      - `boe` number, nullable
      - `well_level` object: Coverage of per-well rows, separate from EIA state aggregate coverage.
        - `status` 'available' | 'not_covered'
        - `latest_period` string, nullable
        - `row_count` integer
        - `well_count` integer
        - `snapshot_generated_at` string, date-time, nullable

## Other responses

- `400`: Invalid period; use YYYY-MM.
- `401`: Unauthorized
- `500`: Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

## Changes

- **2026-10-26** `9e633619fedf`: 5 info
  - added the new optional `query` request parameter `period`
  - added the non-success response with the status `400`
  - added the optional property `data/count` to the response with the `200` status
  - added the optional property `data/period` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/changes/v1/well-production/states/get.md)

---

[API](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1.md) - [All operations](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/revisions/7f8b4d763210?raw)