---
title: "Well cycle-time statistics"
method: GET
path: "/v1/well-production/cycle-time"
tags: ["Well Production"]
---

# Well cycle-time statistics

`GET /v1/well-production/cycle-time`

## Request

- Base URL: `https://api.oilpriceapi.com`
- URL: `https://api.oilpriceapi.com/v1/well-production/cycle-time`
- Auth: API key in header `Authorization`

Aggregate spud-to-completion and completion-to-production cycle-time statistics
(median, percentiles) across wells, with optional filters.

## Response `200`

Cycle-time statistics

- object
  - `status` string
  - `data` object
    - `filters` object
    - `well_count` integer
    - `wells_with_cycle_data` integer
    - `cycle_time_stats` CycleTimeStats
      - `count` integer
      - `median_days` number
      - `p25_days` number
      - `p75_days` number
      - `p90_days` number
      - `min_days` number
      - `max_days` number
      - `avg_days` number
    - `stage_breakdown` object

## Other responses

- `401`: Unauthorized
- `500`: Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1.md) - [All operations](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/revisions/7f8b4d763210?raw)