# List matches for a signal

**`GET https://myagentmail.com/linkedin/signals/{id}/matches`**

Group: LinkedIn — Signals
Operation ID: `linkedinSignalMatches`

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

## Path parameters

- `id` (string, required) —

## Query parameters

- `limit` (integer) —
- `sinceId` (string) —

## Responses

### 200

```json
{
  "matches": [
    {
      "id": "string",
      "kind": "keyword",
      "postUrl": "string",
      "postExcerpt": "string",
      "postPostedAt": "2026-05-01T09:03:22.712Z",
      "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:22.712Z"
    }
  ]
}
```

## Code samples

### TypeScript

```typescript
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" } });
```

### curl

```bash
curl -X GET 'https://myagentmail.com/linkedin/signals/string/matches' \
  -H 'X-API-Key: $MYAGENTMAIL_API_KEY'
```

### Python

```python
import os, requests

r = requests.get(
    "https://myagentmail.com/linkedin/signals/string/matches",
    headers={"X-API-Key": os.environ["MYAGENTMAIL_API_KEY"]},
)
r.raise_for_status()
print(r.json())
```