List cards on a readable board
Same titleContains/textContains/view/includeDeleted contract as MCP list_cards (cardListQuerySchema in lib/schemas/card.ts validates both). titleContains filters server-side, case-insensitively, on card title. textContains (W3-D1) matches case-insensitively on title, description, comment bodies, checklist items AND subtask titles — several words mean every word, each anywhere on the card, an ALIASES: line searched like any text (since 2026-10-16) — always answers view=summary (any other view is refused with 400) and adds match: { field, snippet } — the first field holding every word (title, description, comment, checklist, subtask), or, when the words are spread over fields, the first holding one of them, with a snippet of at most 120 characters; combines with updatedSince (ISO datetime) and citing (a cardKey: cards whose citation graph points at it) — both of which also apply on their own, at every view but lint, which answers every card that needs care and ignores the filters. view defaults to full — today's complete card payload, byte-for-byte unchanged. view=summary returns only id, cardKey, title, listId, startDate, endDate, scheduleState, actualStartDate, actualEndDate, verifiedOn, updatedAt, statusDate, stale (plus match under textContains) — never description, links, verificationSource or assigneeUserIds — to locate a card cheaply before GET /api/cards/{cardId}. statusDate is the dated STATO (or AGGIORNATO) line read from the description's labelled layout, null when neither carries a date; stale is true when that date is more than 14 days old. includeDeleted=true is exclusive trash: only cards with deletedAt set, listId may be null.
Request
- Base URL: https://tre-app.com
- URL: https://tre-app.com/api/boards/{boardId}/cards
- Auth: HTTP bearer
Query parameters
Case-insensitive substring filter on card title (server-side ILIKE, wildcard-escaped).
Case-insensitive substring filter on title, description, comment bodies, checklist items and subtask titles; several words mean every word, each anywhere on the card. Requires view=summary; adds match: { field, snippet } to a returned summary when the hit is locatable.
ISO datetime; only cards updated at or after it.
A cardKey; only cards whose citation graph points at it. A key on a board the caller cannot read answers the empty result, like a key that names no card.
'full' (default) returns every field; 'summary' returns the cheap projection (id, cardKey, title, listId, startDate, endDate, scheduleState, actualStartDate, actualEndDate, verifiedOn, updatedAt, statusDate, stale); 'lint' returns only cards with findings as CardLint rows.
Exclusive trash listing: only cards with deletedAt set. listId may be null. Unlike includeArchived on boards, this is not additive. Default false.
Response
Success
Changes
No recorded changes to this operation across all 1 revision of this API.