companies.list

List the companies on this account

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

What it does

Returns every employer the account has recorded, ordered by name, each with the number of applications filed against it. `search` matches the name case-insensitively. Companies are created as a side effect of filing an application, so this is also the answer to "which employers am I tracking"; use `companies.list_active_with_jobs` instead when the question is "have I already applied here, and for what".

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

applicationCount: integer, required
createdAt: string, required
id: string, required
industry: one of: agriculture, arts, automotive, banking, biotechnology, chemical, communications, construction, consulting, education, electronics, energy, engineering, entertainment, environmental, finance, food, government, healthcare, hospitality, insurance, legal, manufacturing, media, non_profit, pharmaceutical, real_estate, retail, software, sports, technology, telecommunications, transportation, travel, other, unknown, required
linkedin: string or null, required
name: string, required
notes: string or null, required
size: one of: tiny, small, medium, large, massive or null, required
type: one of: government_agency, non_profit, private, public or null, required
updatedAt: string, required
website: string or null, required

hasMore

boolean, required

nextCursor

string or null, required

Examples

The first page of companies

The first page of companies — request

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

The first page of companies — response

{
  "data": [
    {
      "id": "co_42",
      "name": "Northwind",
      "industry": "software",
      "size": "medium",
      "type": "private",
      "website": "https://northwind.example",
      "linkedin": null,
      "notes": null,
      "applicationCount": 3,
      "createdAt": "2026-01-04T09:30:00.000Z",
      "updatedAt": "2026-02-11T17:05:00.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}