---
title: "Get asset run history histogram"
method: GET
path: "/assets/{id}/run-history/histogram"
tags: ["assets"]
---

# Get asset run history histogram

`GET /assets/{id}/run-history/histogram`

Get histogram data for asset run history over specified period

## Path parameters

- `id` string, required

## Query parameters

- `period` string

## Response `200`

OK

- HistogramResponse
  - `buckets` HistogramBucket[]
    - `abort` integer
    - `complete` integer
    - `date` string
    - `fail` integer
    - `other` integer
    - `running` integer
    - `total` integer
  - `period` string

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2025-08-13** `231a3bc352fa` — 1 info
  - endpoint added
- **2025-06-02** `0c070796939d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/marmotdata/apis/marmot-api/changes/assets/:id/run-history/histogram/get.md)

---

[API](https://skmtc.dev/marmotdata/apis/marmot-api.md) · [All operations](https://skmtc.dev/marmotdata/apis/marmot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marmotdata/apis/marmot-api/revisions/cadebfd78fef?raw)