Skip to main content

organization_shares.get

Read one shared board and where to read it from

Request
GET/api/v1/organizations/{organizationSlug}/shares/{shareId}
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_get
Environment
Live and sandbox alike.
Request body
JSON.

What it does

Returns a single share — who shared which board, when, and which cohorts they are in — together with the URLs of the four reads that follow from it: the board, its applications, the flat table view, and the insights dashboard. Use it when you hold a `shr_…` id and want the applicant's board without guessing how to address it. A share held by another organization answers 404, never 403. Staff only, and an organization over its seat limit is refused with 403. Find a share id with `organization_shares.list`.

Parameters

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

Response

applicant
object, required
displayName
string or null, required
email
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
links
object, required
applications
string, required
board
string, required
insights
string, required
table
string, required
sharedAt
string, required

Examples

One student's shared board

One student's shared board — request
curl -s https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center/shares/shr_31 \
  -H "Authorization: Bearer $JAT_KEY"
One student's shared board — response
{
  "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"
    }
  ],
  "links": {
    "board": "https://www.jobapplicationtracking.com/api/v1/boards/brd_7",
    "applications": "https://www.jobapplicationtracking.com/api/v1/boards/brd_7/applications",
    "table": "https://www.jobapplicationtracking.com/api/v1/boards/brd_7/table",
    "insights": "https://www.jobapplicationtracking.com/api/v1/boards/brd_7/insights"
  }
}

Related operations