---
title: "List Shelf"
method: GET
path: "/api/v1/lists/shelf"
tags: ["lists", "lists"]
---

# List Shelf

`GET /api/v1/lists/shelf`

## Request

- Base URL: `https://app.goodleads.club` (the document declares no server; this is the origin it was published from)
- URL: `https://app.goodleads.club/api/v1/lists/shelf`
- Auth: API key in header `X-API-Key`

The time shelf: sellable counts per industry × live state for businesses
filed in the last 7 / 30 / 56 / 90 days and everything on file, each
window's expected find upgrade per record, today's prices, and the window
the run rate of new records is read from. Built at the end of every pipeline
run and stored (backend/services/list_shelf.py); this reads the stored
snapshot, so a buyer's request never computes — a rolled date or a partial
count is rebuilt in the background.

Declared before `GET /lists/{list_id}` so the path is never read as a list id.

## Response `200`

Successful Response

- unknown

---

[API](https://skmtc.dev/goodleads/apis/formation-gtm-api.md) · [All operations](https://skmtc.dev/goodleads/apis/formation-gtm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodleads/apis/formation-gtm-api/revisions/2068d13a82cf?raw)