contacts.list_linkable_applications

Search the applications a contact can be linked to

Request: GET/api/v1/contacts/linkable-applications
Scope required: contacts: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: contacts_list_linkable_applications
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Returns applications on this account matching `search`, reduced to the job title and company name a picker needs. Use it to turn a role a person mentioned into the application id that `contacts.create` and `contacts.update` take, rather than listing every application to find one. Leaving `search` out returns the most recent applications. A page holds at most 50 matches however large a `limit` you ask for, because a picker is not a way to read the whole applications table; `hasMore` and `nextCursor` say when there are more.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
search	query	Optional	string
limit	query	Optional	integer
cursor	query	Optional	string

Response

data

array of object, required

companyName: string, required
id: string, required
title: string, required

hasMore

boolean, required

nextCursor

string or null, required

Examples

Find the application a recruiter was talking about

Find the application a recruiter was talking about — request

curl -s https://www.jobapplicationtracking.com/api/v1/contacts/linkable-applications?search=staff%20engineer \
  -H "Authorization: Bearer $JAT_KEY"

Find the application a recruiter was talking about — response

{
  "data": [
    {
      "id": "app_123",
      "title": "Staff Engineer",
      "companyName": "Acme"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}