---
title: "Get signal occurrence histogram"
method: GET
path: "/v1/projects/{projectSlug}/signals/{signalSlug}/trend"
tags: ["Signals"]
---

# Get signal occurrence histogram

`GET /v1/projects/{projectSlug}/signals/{signalSlug}/trend`

## Request

- Base URL: `https://api.latitude.so`
- URL: `https://api.latitude.so/v1/projects/{projectSlug}/signals/{signalSlug}/trend`
- Auth: HTTP bearer

Returns the occurrence histogram for one signal over `[fromIso, toIso]`. The default range is the trailing 14 days. Buckets are 12-hour wide and UTC-aligned.

## Path parameters

- `projectSlug` string, required: Project slug (human-readable identifier)
- `signalSlug` string, required: Signal slug.

## Query parameters

- `fromIso` string, date-time: Lower bound (inclusive). Defaults to ~14 days before `toIso`.
- `toIso` string, date-time: Upper bound (inclusive). Defaults to now.

## Response `200`

Occurrence histogram

- SignalHistogram
  - `buckets` SignalHistogramBucket[], required: One entry per 12-hour UTC-aligned bucket in the requested range, including empty buckets (`count: 0`).
    - `bucket` string, required: ISO-8601 UTC timestamp of the bucket's start.
    - `count` integer, required: Number of occurrences within the bucket.

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `404`: Not found

## Changes

- **2026-06-18** `94100174a89b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/latitude-dev/apis/latitude/changes/v1/projects/:projectSlug/signals/:signalSlug/trend/get.md)

---

[API](https://skmtc.dev/latitude-dev/apis/latitude.md) - [All operations](https://skmtc.dev/latitude-dev/apis/latitude/llms.txt) - [OpenAPI document](https://skmtc.dev/latitude-dev/apis/latitude/revisions/0685be1cbf9f?raw)