Search

Search items

One endpoint with a generous query string. Mix and match: free-text q, status, type, tag, project_id, due windows, completion. Cursor-paginated.

Endpoint

GET/api/v1/items/search

Returns { items, nextCursor, serverTime }.

Query parameters

  • q — case-insensitive substring on title + content_md.
  • status — backlog | todo | doing | done | archived. Repeat for OR.
  • type — note | todo.
  • tag — tag name. Repeat for AND-of-OR semantics.
  • project_id — uuid.
  • parent_id — uuid, or empty string for top-level only.
  • is_completed — true | false.
  • due_before / due_after — ISO datetimes.
  • include_archived — defaults to false.
  • limit — 1–200, default 50. cursor from prior response.

Examples

curl -G https://quik.md/api/v1/items/search \
  -H "Authorization: Bearer qk_..." \
  --data-urlencode "q=launch" \
  --data-urlencode "status=todo" \
  --data-urlencode "tag=quik"

To paginate, follow nextCursorfrom each response into the next request’s ?cursor=until it’s null.