---
title: "Get the numbers the person keeps"
method: GET
path: "/api/projects/{project_id}/today/pulse_pins/"
tags: ["today"]
---

# Get the numbers the person keeps

`GET /api/projects/{project_id}/today/pulse_pins/`

## Request

- Base URL: `https://us.posthog.com`
- URL: `https://us.posthog.com/api/projects/{project_id}/today/pulse_pins/`
- Auth: HTTP bearer

The numbers the person keeps at the start of the key numbers on their home, in order. Suggestions fill the free places. 404 when the person does not have the new navigation.

## Path parameters

- `project_id` string, required

## Response `200`

- PulsePins
  - `pins` PulsePin[], required: Numbers the person keeps at the start of the key numbers, in order. Suggestions fill the free places. Only the first 4 distinct keys are kept. At most 20 entries.
    - `key` string, required: Key of the number to keep: a key metric setting such as signup_event, or insight:<short_id>.
    - `name` string, required: Name to show for the number until the highlights compute its value.
    - `dashboard_id` integer, nullable: For an insight pinned from a dashboard tile, the dashboard whose filters it keeps. Null otherwise.

## Changes

> 52 revisions in range; 1 not diffed.

- **2026-10-21** `e263ffc38ef5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/posthog/apis/posthog-api/changes/api/projects/:project_id/today/pulse_pins/get.md)

---

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