EvoHub DocsEvoHub Docs Sign in

List a list's cards

Use with AI
View as MarkdownThis page as plain text, for pasting into an AI tool Open in ClaudeAsk Claude questions about this page Open in ChatGPTAsk ChatGPT questions about this page
Connect to Cursor / VS Code / ClaudeSearch and read these docs from your AI tool (MCP server)

MCP server URL

https://docs.evohub.io/mcp

Add to CursorAdd to VS Code

Claude Code

claude mcp add --transport http evohub-docs https://docs.evohub.io/mcp

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, and paste the URL above.

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "evohub-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs.evohub.io/mcp"
      ]
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "evohub-docs": {
      "url": "https://docs.evohub.io/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "evohub-docs": {
      "type": "http",
      "url": "https://docs.evohub.io/mcp"
    }
  }
}

llms.txtllms-full.txt

GET/api/v1/board/lists/{listID}/cards

A page of one list's cards, in display order. Without after the first page comes back; pass the last card's id as after to continue while has_more is true. card_count is how many cards the list holds under the same filters.

Requires the board:card:read scope.

Authorization

Any one of:

Parameters

Path parameters

  • listID string required
    The list's ID.
    Example: lst_2b3c4d5e6f7a48b9c0d1e2f3a4b5c6d7

Query parameters

  • after string
    Continue after this card ID.
  • limit integer
    Cards per page. Default 50, at most 500.
    Default: 50 · Minimum: 1 · Maximum: 500
  • q string
    Match card titles, case-insensitively. A reference such as PLT-42, or a bare number, also matches the card with that number.
  • assignee string
    me keeps only cards the caller is assigned to. Any other value is ignored.
    Value: me
  • label string
    Keep only cards carrying this label ID.
  • due string
    none keeps only cards with no due date.
    Value: none
  • due_from string (date-time)
    Keep only cards due at or after this RFC 3339 instant.
  • due_to string (date-time)
    Keep only cards due at or before this RFC 3339 instant.
  • created_from string (date-time)
    Keep only cards created at or after this RFC 3339 instant.
  • created_to string (date-time)
    Keep only cards created at or before this RFC 3339 instant.

Responses

200

A page of cards.

Content type: application/json

Type: object

  • data object
    • cards array of Card
      Show Card properties
      • id string
        Example: crd_9f2e4d6c8b0a1e3f5d7c9b1a3e5f7d90
      • board_id string
      • list_id string
      • number integer
        The card's number on its board, from 1. With the board's card_prefix it is the card's reference.
      • title string
        Max length: 200
      • description string
        Max length: 20000
      • color string
        A hex colour, or "" for none.
      • due_at string (date-time)
        Absent when the card has no due date.
      • review Review
        Show Review properties
        • state string
          One of: pending approved
        • approved_by string
        • approved_at string (date-time)
      • completed_at string (date-time)
        When the card entered a done list. Absent while it is not in one.
      • created_by string
      • created_at string (date-time)
      • updated_at string (date-time)
      • version integer
        Goes up by one on every edit of the title or description.
      • assignee_ids array of string | null
        Who the card is on. Filled in when a board or list is read; null when one card is read on its own.
      • label_ids array of string | null
        The labels the card carries. Filled in when a board or list is read; null when one card is read on its own.
    • card_count integer
    • has_more boolean

400

A date filter is not an RFC 3339 timestamp (VALIDATION_ERROR).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

401

No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

403

The key lacks the scope this endpoint needs (FORBIDDEN).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

404

It does not exist, or it is on a board the caller cannot see (NOT_FOUND).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

429

Too many requests (RATE_LIMITED). Wait for Retry-After seconds.

Headers

  • Retry-After integer
    Seconds to wait before retrying.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

500

Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: NOT_FOUND
    • message string required
      Example: not found
    • request_id string

Example request

curl -X GET 'https://evohub.io/api/v1/board/lists/lst_2b3c4d5e6f7a48b9c0d1e2f3a4b5c6d7/cards' \
  -H 'Authorization: Bearer <TOKEN>'