people.get_overview

Summarise the networking side of this job search

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

What it does

Answers who is owed a follow-up, which interviews are coming up, what was said recently, and how much networking happened over the window. Two parts deliberately ignore `range`: upcoming interviews, and the "gone quiet" rule behind the follow-up list, because both are about what to do next rather than about a historical window. Reach for this before `contacts.list` when the question is what to do rather than who exists; `people.get_analytics` has the comparison against the previous window.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
range	query	Optional	one of: 7d, 30d, 90d, 1y, all

Response

followUps

array of object, required

companyName: string or null, required
contactId: string, required
lastInteractionAt: string or null, required
name: string, required
reason: one of: follow_up_logged, gone_quiet, required

generatedAt

string, required

headline

object, required

activeContactsInRange: integer, required
interactionsInRange: integer, required
totalContacts: integer, required
upcomingInterviews: integer, required

interactionsByType

array of object, required

count: integer, required
type: one of: call, direct_message, email, follow_up, job_fair, meeting, networking_event, recruiter_outreach, reference_check, referral, social_media, thank_you_note, other, required

interactionVolume

array of object, required

countsByType: object, required
label: string, required
startsOn: string, required
total: integer, required

range

one of: 7d, 30d, 90d, 1y, all, required

recentInteractions

array of object, required

companyName: string or null, required
contactId: string, required
contactName: string, required
interactionId: string, required
interactionTime: string, required
notes: string or null, required
type: one of: call, direct_message, email, follow_up, job_fair, meeting, networking_event, recruiter_outreach, reference_check, referral, social_media, thank_you_note, other, required

upcomingInterviews

array of object, required

applicationId: string, required
companyName: string, required
contactNames: array of string, required
interviewId: string, required
jobName: string, required
time: string, required

Examples

The last thirty days of networking

The last thirty days of networking — request

curl -s https://www.jobapplicationtracking.com/api/v1/people/overview?range=30d \
  -H "Authorization: Bearer $JAT_KEY"

The last thirty days of networking — response

{
  "range": "30d",
  "generatedAt": "2026-02-11T17:05:00.000Z",
  "headline": {
    "totalContacts": 24,
    "activeContactsInRange": 6,
    "interactionsInRange": 11,
    "upcomingInterviews": 1
  },
  "followUps": [
    {
      "contactId": "ct_42",
      "name": "Dana Okafor",
      "companyName": "Acme",
      "lastInteractionAt": "2026-01-06T15:00:00.000Z",
      "reason": "gone_quiet"
    }
  ],
  "upcomingInterviews": [],
  "recentInteractions": [],
  "interactionVolume": [],
  "interactionsByType": [
    {
      "type": "email",
      "count": 11
    }
  ]
}

people.get_overview

What it does

Parameters

Response

Examples

The last thirty days of networking

Related operations