Get a signal

One signal with its 25 most recent matches and the evidence for each.

GEThttps://app.trygtm.com/api/v1/signals/{signal_id}

Scope: read
MCP tool: get_signal

Path parameters

signal_idstringrequired: The signal's id, from list_signals.

Request

curl https://app.trygtm.com/api/v1/signals/8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10 \
  -H "Authorization: Bearer $TRYGTM_API_KEY"

Response

{
  "data": {
    "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
    "name": "Route optimisation chatter",
    "kind": "keyword_engagement",
    "status": "active",
    "definition": {
      "keywords": [
        "route optimization"
      ],
      "platform": "linkedin"
    },
    "last_run_at": "2026-09-18T09:58:00.000Z",
    "recent_matches": [
      {
        "id": "a9b8c7d6-e5f4-4a3b-8c2d-1e0f9a8b7c6d",
        "contact_id": "8f2a91c4-6d1e-4c0a-9a57-2f3b1c7e9d10",
        "score": 4,
        "evidence_snippet": "Commented on a post about last-mile routing.",
        "evidence_url": "https://www.linkedin.com/feed/update/example",
        "detected_at": "2026-09-12T14:02:11.000Z"
      }
    ]
  }
}