Lists

List lists

Required permissions: people:read.

A page of your lists, most recently created first. PAGINATES: follow nextCursor until hasMore is false.

Lists are scoped to the USER your key acts as, matching the app: you see the lists this key created, and they appear in the Trayo app under that user. Another user's list in the same workspace is indistinguishable from a non-existent one.

get/v1/lists

Request

  • Base URL: https://api.trayo.ai
  • URL: https://api.trayo.ai/v1/lists
  • Auth: HTTP bearer

Query parameters

qstring

Case-insensitive substring match against name only.

updatedSincestring

Send a plain date — 2026-06-07, read as midnight UTC — or a full ISO-8601 timestamp — 2026-06-07T14:30:00Z — when you need the time of day. Relative words are not accepted: yesterday, last-quarter, 7d and anything else that has to be resolved against "now" is rejected with a 400 (invalid_date). Compute the date yourself and send it. Only lists whose updatedAt is at or after this value. Renaming a list moves updatedAt; adding or removing members does not.

limitinteger

Page size, default 25, max 100.

cursorstring

A previous page's nextCursor, verbatim.

Response

hasMoreboolean required

Another page exists. When false you have reached the end — stop requesting pages.

nextCursorstring nullable required

Pass verbatim as the next request's cursor to fetch the next page. Null exactly when hasMore is false.

Changes

No recorded changes to this operation across all 1 revision of this API.