List the lists

Lists (audiences) in the workspace, with member counts. Campaigns target lists. A static list holds the people put on it; a signal list resolves to whoever a signal matched.

GEThttps://app.trygtm.com/api/v1/lists
Scope
read
MCP tool
list_lists

Query parameters

kindstringoptional
Only lists of this kind.staticsignalfilter
limitintegeroptionaldefault: 25
Rows per page, 1 to 100.
cursorstringoptional
Opaque cursor from the previous page's next_cursor. Omit for the first page. Keep every other argument the same while paging.

Request

curl -G https://app.trygtm.com/api/v1/lists \
  -H "Authorization: Bearer $TRYGTM_API_KEY" \
  --data-urlencode "limit=25"

Response

{
  "data": [
    {
      "id": "5e6f7a8b-1c2d-4e3f-9a0b-1c2d3e4f5a6b",
      "name": "Logistics VPs — US",
      "description": null,
      "kind": "static",
      "signal_id": null,
      "icp_definition_id": null,
      "member_count": 412,
      "created_at": "2026-08-28T10:00:00.000Z",
      "updated_at": "2026-09-10T15:45:00.000Z"
    }
  ],
  "next_cursor": "WyIyMDI2LTA5LTAyVDA5OjQxOjAyLjAwMFoiLCI4ZjJhOTFjNC02ZDFlLTRjMGEtOWE1Ny0yZjNiMWM3ZTlkMTAiXQ"
}

Was this page helpful?