Skip to main content

applications.get

Read one application

Request
GET/api/v1/applications/{applicationId}
Scope required
applications:read
Effect
Reads only. Safe to retry and safe for an agent to call unprompted.
Acts on
Serves an account’s own data and, where shared, an organization’s.
MCP tool
applications_get
Environment
Live and sandbox alike.
Request body
JSON.

What it does

Returns one card with its job, company, compensation, location, résumé and its interview and coach-note counts. An applicant reading their own card gets `visibility: "full"`. A credential belonging to organization staff gets `visibility: "redacted"` and the smaller shape the applicant shared — the applicant's résumé is never part of it. A card belonging to nobody this credential may read answers 404, never 403. The response carries a weak `ETag`; send it back as `If-Match` on `applications.update` or `applications.delete` to be refused rather than overwrite a change somebody else made in the meantime.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
NameSent inRequirementAccepts
applicationIdpathRequiredstring
If-MatchheaderOptionalstring — The ETag of the version you read. The write is refused with 412 if the resource has changed since.

Response

Answers 200 with no body.

Examples

An applicant reading their own card

An applicant reading their own card — request
curl -s https://www.jobapplicationtracking.com/api/v1/applications/app_123 \
  -H "Authorization: Bearer $JAT_KEY"
An applicant reading their own card — response
{
  "visibility": "full",
  "application": {
    "id": "app_123",
    "boardId": "brd_7",
    "status": "applied",
    "statusChangedAt": "2026-02-11T17:05:00.000Z",
    "applicationDate": "2026-02-11T00:00:00.000Z",
    "applicationLink": "https://example.com/jobs/staff-engineer",
    "source": "LinkedIn",
    "notes": "Referred by a former colleague.",
    "isAutoRetired": false,
    "creationMethod": "form",
    "job": {
      "title": "Staff Engineer",
      "description": "Own the billing platform.",
      "workMode": "remote",
      "workType": "full_time",
      "location": {
        "street": null,
        "street2": null,
        "city": "Austin",
        "state": "Texas",
        "country": "United States",
        "postalCode": null
      },
      "compensation": {
        "payAmount": 195000,
        "payFrequency": "annually",
        "currency": "USD",
        "salaryRangeMin": null,
        "salaryRangeMax": null
      }
    },
    "company": {
      "id": "co_42",
      "name": "Northwind",
      "industry": "software",
      "size": "medium",
      "type": "private",
      "website": "https://northwind.example",
      "linkedin": null
    },
    "resume": null,
    "counts": {
      "interviews": 1,
      "coachNotes": 0
    },
    "createdAt": "2026-02-11T17:05:00.000Z",
    "updatedAt": "2026-02-11T17:05:00.000Z"
  }
}

Related operations