---
title: "State oil & gas activity snapshot (aggregates)"
method: GET
path: "/state/{state}/snapshot"
tags: ["state"]
---

# State oil & gas activity snapshot (aggregates)

`GET /state/{state}/snapshot`

## Request

- Base URL: `https://www.buckheadenergy.com/api/v1`
- URL: `https://www.buckheadenergy.com/api/v1/state/{state}/snapshot`
- Auth: none declared

Aggregate state counts plus the top operators by wells operated, top counties and formations. No per-well lists and no drilling activity attributed to an operator.

## Path parameters

- `state` 'TX' | 'OK' | 'NM' | 'ND' | 'CO' | 'WY' | 'CA' | 'KS' | 'MS' | 'UT' | 'IL' | 'MT' | 'AL' | 'AR' | 'IN' | 'KY' | 'LA' | 'MI' | 'NE' | 'OH' | 'PA' | 'SD' | 'TN' | 'WV', required

## Response `200`

State snapshot

- SnapshotEnvelope
  - `data` object
    - `state` string
    - `counts` object: Aggregate counts. permits12mo / spuds12mo / firstProd12mo are null when unknown, withheld, or held (see drillingHeld).
    - `topOperators` object[]
    - `topCounties` object[]
    - `topFormations` object[]
    - `dataAsOf` string, nullable
    - `drillingHeld` object, nullable: Present when the state's permit, spud and first-production counts are held while the source is reconciled with state records.
      - `held` true
      - `reason` 'reconciling-with-state-records'
      - `note` string
      - `since` string
      - `regulator` object
        - `name` string
        - `url` string
  - `meta` Meta
    - `apiVersion` string
    - `dataAsOf` string, date, nullable: Date the underlying metrics were last refreshed
    - `source` string: Attribution

## Other responses

- `400`: Invalid input
- `404`: Resource not found

---

[API](https://skmtc.dev/buckheadenergy/apis/buckhead-energy-public-api.md) · [All operations](https://skmtc.dev/buckheadenergy/apis/buckhead-energy-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buckheadenergy/apis/buckhead-energy-public-api/revisions/c058c2f3e2e9?raw)