EvoHub DocsEvoHub Docs Sign in

List a board's lists and 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/boards/{boardID}/lists

The board's lists in display order, each with the first page of its cards. Each list says how many cards it holds (card_count) and whether more exist (has_more); read further with List a list's cards. The filters below narrow which cards count as being in a list, the counts included.

Requires the board:list:read scope.

Authorization

Any one of:

Parameters

Path parameters

  • boardID string required
    The board's ID.
    Example: brd_5b0c8e1a2f3d4c6b9a7e0d1f2c3b4a59

Query parameters

  • cards integer
    Cards per list. 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

The lists and their first cards.

Content type: application/json

Type: object

  • data object
    • lists array of List
      Show List properties
      • id string
      • board_id string
      • name string
        Max length: 80
      • is_review_list boolean
      • is_done_list boolean
      • celebration Celebration
        One of: confetti hearts sparkles fireworks balloons bubbles petals emoji glow
      • created_by string
      • created_at string (date-time)
      • updated_at string (date-time)
      • cards array of Card
        The first page of the list's cards.
        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
        How many cards the list holds, under the filters.
      • 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/boards/brd_5b0c8e1a2f3d4c6b9a7e0d1f2c3b4a59/lists' \
  -H 'Authorization: Bearer <TOKEN>'