organization_shares.list
List the boards applicants have shared with an organization
- Request
- GET
/api/v1/organizations/{organizationSlug}/shares - Scope required
organizations:read- Effect
- Reads only. Safe to retry and safe for an agent to call unprompted.
- Acts on
- Acts on an organization, and names it in the path.
- MCP tool
organization_shares_list- Environment
- Live and sandbox alike.
- Request body
- JSON.
What it does
Returns every board an applicant has chosen to show this organization, most recently shared first, with the cohorts each applicant is currently in. This is the entry point to an applicant's data: take the `board.id` from a row and read it with `boards.get`, `applications.list`, `table.list_rows` and `insights.get_dashboard`, exactly as the web app does. Those reads are read-only for staff — a write against a board you do not own answers 404. Staff only, and an organization over its seat limit is refused with 403 until an owner adds seats or removes applicants.
Parameters
| Name | Sent in | Requirement | Accepts |
|---|---|---|---|
| organizationSlug | path | Required | string |
| limit | query | Optional | integer |
| cursor | query | Optional | string |
Response
- data
- array of object, required
- applicant
- object, required
- displayName
- string or null, required
- string, required
- board
- object, required
- applicationCount
- integer, required
- id
- string, required
- isActive
- boolean, required
- name
- string, required
- cohorts
- array of object, required
- id
- string, required
- name
- string, required
- id
- string, required
- sharedAt
- string, required
- hasMore
- boolean, required
- nextCursor
- string or null, required
Examples
The boards a career centre can read
curl -s https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center/shares \
-H "Authorization: Bearer $JAT_KEY"{
"data": [
{
"id": "shr_31",
"applicant": {
"email": "student@northside.example",
"displayName": "Sam Okafor"
},
"board": {
"id": "brd_7",
"name": "Spring search",
"isActive": true,
"applicationCount": 12
},
"sharedAt": "2026-01-08T09:00:00.000Z",
"cohorts": [
{
"id": "coh_12",
"name": "Spring 2026 intake"
}
]
}
],
"hasMore": false,
"nextCursor": null
}