# GET /v1/durable/metrics/timeseries - Get metrics time series

Source: <https://everruns.com/docs/api/operations/get_metrics_timeseries/>

GET

/v1/durable/metrics/timeseries

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/durable/metrics/timeseries';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/durable/metrics/timeseries
```

* Production APIapp.everruns.com/api/v1/durable/metrics/timeseries

## Responses

### 200

Metrics time series

Media typeapplication/json

Metrics time series response.

In multi-instance deployments, each instance maintains its own metrics ring buffer. The `instance_count` field indicates how many instances are expected so consumers can aggregate or label appropriately.

object

**instance\_count**

Number of expected control-plane instances (from EXPECTED\_INSTANCES env). When >1, these metrics represent only this instance’s view.

integer format: int32

**points**

required

Array\<object>

Single metrics data point

object

**active\_workers**

required

Number of workers actively heartbeating (gauge).

integer

**claimed\_tasks**

required

Number of tasks currently claimed by a worker (gauge).

integer

**dlq\_size**

required

Size of the dead-letter queue (gauge).

integer

**load\_percentage**

required

Aggregate worker load as a percentage of total `max_concurrency` (0.0-100.0).

number format: double

**pending\_tasks**

required

Number of tasks waiting to be claimed by a worker (gauge).

integer

**pending\_workflows**

required

Number of workflows waiting to be claimed by a worker (gauge).

integer

**running\_workflows**

required

Number of workflows currently executing (gauge).

integer

**tasks\_completed\_total**

required

Cumulative count of tasks completed successfully since process start (monotonic counter).

integer format: int64

**tasks\_failed\_total**

required

Cumulative count of tasks that failed or were sent to the DLQ (monotonic counter).

integer format: int64

**tasks\_started\_total**

required

Cumulative count of tasks claimed at least once (monotonic counter).

integer format: int64

**timestamp**

required

Sampling timestamp for this data point (RFC 3339).

string format: date-time

**workflows\_completed\_total**

required

Cumulative count of workflows that completed successfully (monotonic counter).

integer format: int64

**workflows\_failed\_total**

required

Cumulative count of workflows that ended in failure (monotonic counter).

integer format: int64

**workflows\_started\_total**

required

Cumulative count of workflows that started (monotonic counter).

integer format: int64

**resolution\_seconds**

required

integer format: int64

##### Example

```json
{
  "points": [
    {
      "active_workers": 4,
      "claimed_tasks": 28,
      "dlq_size": 3,
      "load_percentage": 62.5,
      "pending_tasks": 12,
      "pending_workflows": 7,
      "running_workflows": 42,
      "tasks_completed_total": 12843,
      "tasks_failed_total": 17,
      "tasks_started_total": 12873,
      "timestamp": "2026-05-27T15:30:00Z",
      "workflows_completed_total": 982,
      "workflows_failed_total": 3,
      "workflows_started_total": 1024
    }
  ]
}
```