contacts.list

List the contacts on this account

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

What it does

Returns the people this account keeps track of, surname first by default, each with the companies and applications they are linked to. `search` matches a name, an email address or a company name; `companyId` and `boardId` narrow the list to the people attached to one company or to the applications on one board. Walk the pages with `cursor`. Use `contacts.get` for one person by id, and `interactions.list` for what has been said to them.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
search	query	Optional	string
companyId	query	Optional	string
boardId	query	Optional	string
sort	query	Optional	one of: last_name_asc, first_name_asc, created_at_desc, updated_at_desc
limit	query	Optional	integer
cursor	query	Optional	string

Response

data

array of object, required

applications

array of object, required

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

Examples

The first page of contacts

The first page of contacts — request

curl -s https://www.jobapplicationtracking.com/api/v1/contacts \
  -H "Authorization: Bearer $JAT_KEY"

The first page of contacts — response

{
  "data": [
    {
      "id": "ct_42",
      "firstName": "Dana",
      "lastName": "Okafor",
      "email": "dana@acme.example",
      "phone": null,
      "category": "Recruiter",
      "source": "LinkedIn",
      "notes": "Owns hiring for the platform team.",
      "companies": [
        {
          "id": "co_42",
          "name": "Acme"
        }
      ],
      "applications": [
        {
          "id": "app_123",
          "title": "Staff Engineer",
          "companyName": "Acme"
        }
      ],
      "createdAt": "2026-01-04T09:30:00.000Z",
      "updatedAt": "2026-02-11T17:05:00.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}