interactions.list

List logged interactions with contacts

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

What it does

Returns every conversation logged against this account's contacts, most recent first. Narrow with `contactId` for one person, `type` for one kind of contact, and `from`/`to` for a window of time — both are ISO-8601 instants compared against `interactionTime`, the moment the conversation happened rather than the moment it was written down. Use `interactions.create` to add one and `people.get_overview` for who is overdue a follow-up.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
contactId	query	Optional	string
type	query	Optional	one of: call, direct_message, email, follow_up, job_fair, meeting, networking_event, recruiter_outreach, reference_check, referral, social_media, thank_you_note, other
from	query	Optional	string
to	query	Optional	string
sort	query	Optional	one of: interaction_time_desc, interaction_time_asc, created_at_desc, updated_at_desc
limit	query	Optional	integer
cursor	query	Optional	string

Response

data

array of object, required

contactId: string, required
createdAt: string, required
id: 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
updatedAt: string, required

hasMore

boolean, required

nextCursor

string or null, required

Examples

Everything said to one contact

Everything said to one contact — request

curl -s https://www.jobapplicationtracking.com/api/v1/interactions?contactId=ct_42 \
  -H "Authorization: Bearer $JAT_KEY"

Everything said to one contact — response

{
  "data": [
    {
      "id": "ix_88",
      "contactId": "ct_42",
      "type": "email",
      "notes": "Asked about the timeline for the platform team role.",
      "interactionTime": "2026-02-10T15:00:00.000Z",
      "createdAt": "2026-02-10T15:04:00.000Z",
      "updatedAt": "2026-02-10T15:04:00.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}