---
title: "Formation mix and median lateral length by year"
method: GET
path: "/state/{state}/lateral-trends"
tags: ["state"]
---

# Formation mix and median lateral length by year

`GET /state/{state}/lateral-trends`

## Request

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

Share of permits and median lateral length (feet) by year for the state's leading formations.

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

Formation mix and median lateral length by year

- object
  - `data` object
    - `formations` string[]
    - `years` object[]
    - `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)