---
title: "Permit-to-spud and spud-to-production cycle times"
method: GET
path: "/state/{state}/cycle-times"
tags: ["state"]
---

# Permit-to-spud and spud-to-production cycle times

`GET /state/{state}/cycle-times`

## Request

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

Days from permit to spud and from spud to first production (25th / 50th / 75th percentile) and permit conversion, for the state and its top 25 counties.

## 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`

Permit-to-spud and spud-to-production cycle times

- object
  - `data` object
    - `state` 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
    - `counties` 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
    - `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)