---
title: "Preview new cards held by today's cap (Markdown)"
method: GET
path: "/dev/due/upcoming-new"
---

# Preview new cards held by today's cap (Markdown)

`GET /dev/due/upcoming-new`

## Request

- Base URL: `https://fluidrecall.com/api/v1`
- URL: `https://fluidrecall.com/api/v1/dev/due/upcoming-new`
- Auth: one of:
  - HTTP bearer
  - HTTP dpop

Routine read. Prompts only. These cards are past newCardsPerDay. Reviewing one counts as an introduction. This call does not change the stored allowance.

## Query parameters

- `asOf` string: UTC ISO-8601 timestamp ending in Z
- `deckId` string, uuid
- `limit` integer

## Response `200`

Markdown list of held-back new cards. Prompts only.

## Other responses

- `400`: Invalid JSON or fields.
- `401`: Missing or wrong token.

---

[API](https://skmtc.dev/fluidrecall/apis/fluid-recall.md) · [All operations](https://skmtc.dev/fluidrecall/apis/fluid-recall/llms.txt) · [OpenAPI document](https://skmtc.dev/fluidrecall/apis/fluid-recall/revisions/7bf2563c3d2a?raw)