---
title: "County metrics"
method: GET
path: "/counties/{state}/{county}/metrics"
tags: ["counties"]
---

# County metrics

`GET /counties/{state}/{county}/metrics`

## Request

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

One county: monthly permits / spuds / first production (last 24 months), cycle times, DUC aging and momentum score. No operator breakdown.

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

## Response `200`

County metrics

- object
  - `data` object
    - `state` string
    - `countySlug` string
    - `monthly` MonthlyActivity[]
      - `month` string
      - `permits` integer, nullable
      - `spuds` integer, nullable
      - `firstProd` integer, nullable
    - `cycleTimes` CycleTimes
      - `state` string
      - `countySlug` string, nullable
      - `countyName` string, nullable
      - `operatorSlug` string, nullable
      - `operatorName` string, nullable
      - `permitToSpud` Percentiles: Days; a percentile resting on fewer than 5 wells is withheld (null).
        - `n` integer, nullable
        - `p25` number, nullable
        - `p50` number, nullable
        - `p75` number, nullable
      - `spudToProduction` Percentiles: Days; a percentile resting on fewer than 5 wells is withheld (null).
        - `n` integer, nullable
        - `p25` number, nullable
        - `p50` number, nullable
        - `p75` number, nullable
      - `conversion` object, nullable
        - `permits` integer, nullable
        - `spudded` integer, nullable
        - `rate` number, nullable
    - `ducAging` DucAging
      - `state` string
      - `countySlug` string, nullable
      - `countyName` string, nullable
      - `ducCount` integer, nullable
      - `p25` integer, nullable
      - `p50` integer, nullable
      - `p75` integer, nullable
      - `p90` integer, nullable
    - `momentum` Momentum: score = 100 x (permits last 12 mo / prior 12) x (BOE last 12 mo / prior 12).
      - `score` integer
      - `permits` object
        - `prior` integer
        - `recent` integer
        - `ratio` number
      - `production` object
        - `prior` integer
        - `recent` integer
        - `ratio` number
        - `through` string
    - `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)