List matches for a signal

GEThttps://myagentmail.com/linkedin/signals/{id}/matches

All historical matches for this signal, newest first. Pull-based alternative to webhooks.

Path parameters

id

required

string

Query parameters

`limit` integer
`sinceId` string

Responses

200application/json

`matches` object[]
`id` string
`kind` "keyword" \| "engagement" \| "job_change"	enum: "keyword" \| "engagement" \| "job_change"
`postUrl` string
`postExcerpt` string
`postPostedAt` string	format: date-time
`engagement` object
`action` "commented" \| "reacted"	enum: "commented" \| "reacted"
`commentText` string
`jobChange` object
`oldRole` string
`oldCompany` string
`newRole` string
`newCompany` string
`author` object
`name` string
`profileUrl` string
`headline` string	From the verified LinkedIn profile lookup.
`role` string	Parsed current role (e.g. "Founder & CEO"). null when profile lookup was deferred.
`company` string	Parsed current company. null when profile lookup was deferred.
`classification` object
`engage` boolean
`intent` "low" \| "medium" \| "high"	enum: "low" \| "medium" \| "high"
`reason` string
`triageScore` integer	Pass-1 triage classifier score (0-100). Posts below the threshold are not persisted.
`pendingEnrichment` boolean	true when the post passed triage but the daily profile-lookup cap forced us to skip the full Pass-2 verification. Webhook delivery is held until the next poll fully verifies the match.
`foundAt` string	format: date-time

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /linkedin/signals/{id}/matches
const result = await client.request("get", "/linkedin/signals/{id}/matches", { params: { id: "string" } });

Example response · 200

{
  "matches": [
    {
      "id": "string",
      "kind": "keyword",
      "postUrl": "string",
      "postExcerpt": "string",
      "postPostedAt": "2026-05-01T09:03:23.011Z",
      "engagement": {
        "action": "commented",
        "commentText": "string"
      },
      "jobChange": {
        "oldRole": "string",
        "oldCompany": "string",
        "newRole": "string",
        "newCompany": "string"
      },
      "author": {
        "name": "string",
        "profileUrl": "string",
        "headline": "string",
        "role": "string",
        "company": "string"
      },
      "classification": {
        "engage": false,
        "intent": "low",
        "reason": "string"
      },
      "triageScore": 0,
      "pendingEnrichment": false,
      "foundAt": "2026-05-01T09:03:23.011Z"
    }
  ]
}