---
title: "Formation-level aggregates (well count, active operators, top operators by wells operated, primary counties)"
method: GET
path: "/formations/{state}/{slug}"
tags: ["formations"]
---

# Formation-level aggregates (well count, active operators, top operators by wells operated, primary counties)

`GET /formations/{state}/{slug}`

## Request

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

## 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
- `slug` string, required

## Response `200`

Formation detail

- FormationEnvelope
  - `data` object
    - `formation` object
      - `state` string
      - `formationSlug` string
      - `formationName` string
      - `wellCount` integer
      - `activeOperators` integer
      - `recentPermits24Mo` integer: Absent when the state's drilling counts are held (see held).
      - `primaryCounties` unknown
      - `topOperators` unknown
      - `dataAsOf` string, nullable
      - `held` Held (unresolved $ref)
      - `reason` Reason (unresolved $ref)
      - `note` Note (unresolved $ref)
  - `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)