companies.get

Read one company

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

What it does

Returns a single employer with its profile and the number of applications the account has filed against it. A company belonging to another account answers 404, never 403. The response carries a weak `ETag` for use as `If-Match` on `companies.update`.

Parameters

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

Response

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

Examples

One employer and how often you have applied there

One employer and how often you have applied there — request

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

One employer and how often you have applied there — response

{
  "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"
}