---
title: "Read the new-card allowance"
method: GET
path: "/settings"
---

# Read the new-card allowance

`GET /settings`

## Request

- Base URL: `https://fluidrecall.com/api/v1`
- URL: `https://fluidrecall.com/api/v1/settings`
- Auth: one of:
  - HTTP bearer
  - HTTP dpop

Routine read. Account newCardsPerDay, IANA timezone (UTC until changed), and dayBoundaryHour (4 until changed, meaning 04:00 local). newCardsPerDay here is the fallback for a deck whose own field is null. A fresh account may show 20 because that column default is a legacy fallback, not a number you chose for a deck. Choose newCardsPerDay with the person for this deck. There is no default of 20. When they have a deadline, call previewDeadlinePlan first: it returns ceil(remaining new cards / study days) as a floor. Weigh study time (more time, a higher number), that deadline floor, and card complexity (tiny facts such as times tables can be higher; a beefy card such as the five steps of a cycle must be lower). You may raise N above the floor or negotiate more study time. Send that integer. After bulk card adds, re-run previewDeadlinePlan with that deckId and consider applyDeadlinePlan or updateDeck. 0 introduces no new cards unless the caller asks for extras.

## Response `200`

The account study settings.

- StudySettings
  - `newCardsPerDay` integer, required: Account fallback used only when a deck's newCardsPerDay is null. A stored 20 on a new account is the legacy column default, not a coaching choice. Set the deck explicitly.
  - `timezone` string, required: IANA timezone for the study day. UTC unless changed.
  - `dayBoundaryHour` integer, required: Local hour when the study day starts. 4 means 04:00. Before that hour, the previous study day is still in effect.

## Other responses

- `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)