Skip to main content

shares.list

List the boards this account has shared with organizations

Request
GET/api/v1/shares
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
shares_list
Environment
Live and sandbox alike.
Request body
JSON.

What it does

Returns every share this applicant has created: which board, which organization, and when. A share is read-only consent — the organization's staff can see the board and leave coach notes on it, and can change nothing. Create one with `shares.create` and withdraw one with `shares.delete`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
NameSent inRequirementAccepts
limitqueryOptionalinteger
cursorqueryOptionalstring

Response

data
array of object, required
boardId
string, required
boardName
string, required
createdAt
string, required
id
string, required
organization
object, required
name
string, required
slug
string, required
hasMore
boolean, required
nextCursor
string or null, required

Examples

One board shared with a career centre

One board shared with a career centre — request
curl -s https://www.jobapplicationtracking.com/api/v1/shares \
  -H "Authorization: Bearer $JAT_KEY"
One board shared with a career centre — response
{
  "data": [
    {
      "id": "shr_42",
      "boardId": "brd_7",
      "boardName": "Spring search",
      "organization": {
        "slug": "northwind-careers",
        "name": "Northwind Careers"
      },
      "createdAt": "2026-02-01T09:30:00.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

Related operations