organizations.get

Read one organization

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

What it does

Returns an organization, the role the calling account holds in it, and — for staff only — the seat allowance. `myRole` is worth reading before you try to change anything: an owner may do everything, an admin everything but billing and touching another owner, a coach may invite applicants and write notes, and an applicant may only read. An organization the account does not belong to answers 404, never 403, so a slug cannot be probed for existence. An applicant member receives `seats: null`. The people behind `myRole` are listed by `members.list`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
organizationSlug	path	Required	string

Response

createdAt: string, required
id: string, required
myRole: one of: owner, admin, coach, applicant, required
name: string, required
seats: object or null, required
slug: string, required
type: one of: career_coach, bootcamp, college, trade_school, government, other, required
updatedAt: string, required
website: string or null, required

Examples

A career centre read by one of its owners

A career centre read by one of its owners — request

curl -s https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center \
  -H "Authorization: Bearer $JAT_KEY"

A career centre read by one of its owners — response

{
  "id": "org_5c1f9a7e-2b64-4f0b-9c2a-7d8e1f3a4b5c",
  "slug": "northside-career-center",
  "name": "Northside Career Center",
  "type": "college",
  "website": "https://careers.northside.example",
  "createdAt": "2026-01-04T09:30:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z",
  "myRole": "owner",
  "seats": {
    "limit": 25,
    "inUse": 18,
    "available": 7,
    "isOverLimit": false,
    "freeSeats": 3,
    "complimentarySeats": 2,
    "purchasedSeats": 20,
    "subscriptionStatus": "active"
  }
}