---
title: "List pinned documents"
method: GET
path: "/pins"
tags: ["Pinned documents"]
---

# List pinned documents

`GET /pins`

## Request

- Base URL: `https://app.jitprompt.com`
- URL: `https://app.jitprompt.com/pins`
- Auth: HTTP bearer

The pinned documents in order, each with its estimated tokens, and the
block's total against the namespace's cap. Every client agent gets the
pinned documents without asking: in the MCP `instructions`, or at the top
of its first get_toc or search_instructions response. A document with
`included: false` is pinned but left out — not ready yet, or past the cap
since an edit grew it.

## Response `200`

Successful Response

- Pins
  - `pins` PinnedDocument[], required
    - `id` string, required
    - `title` string, required
    - `source_name` string, required
    - `status` string, required
    - `est_tokens` integer, required
    - `included` boolean, required
  - `total_tokens` integer, required
  - `cap` integer, required
  - `max` integer, required

---

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