boards.list

List the boards on this account

Request: GET/api/v1/boards
Scope required: boards:read
Effect: Reads only. Safe to retry and safe for an agent to call unprompted.
Acts on: Acts on the account’s own job search.
MCP tool: boards_list
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Returns every board the account owns, newest first, ordered by `createdAt desc, id desc`. Exactly one board is active at a time and that is the one the web app opens on, so filter on `isActive` when you need the board a person is currently working in. Walk the pages with `cursor`, which the previous page returns as `nextCursor`. Read one whole with `boards.get`, and open a new one with `boards.create`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
limit	query	Optional	integer
cursor	query	Optional	string

Response

data

array of object, required

applicationCount: integer, required
createdAt: string, required
id: string, required
isActive: boolean, required
name: string, required
updatedAt: string, required

hasMore

boolean, required

nextCursor

string or null, required

Examples

The first page of boards

The first page of boards — request

curl -s https://www.jobapplicationtracking.com/api/v1/boards \
  -H "Authorization: Bearer $JAT_KEY"

The first page of boards — response

{
  "data": [
    {
      "id": "brd_7",
      "name": "Spring search",
      "isActive": true,
      "applicationCount": 12,
      "createdAt": "2026-01-04T09:30:00.000Z",
      "updatedAt": "2026-02-11T17:05:00.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}