Get Companies in Swimlane
affinity_get_companies_in_swimlaneRetrieve companies in a specific pipeline stage (swimlane) from an Affinity list by providing list ID and swimlane ID.
Instructions
Get all companies at a specific pipeline stage (swimlane).
Returns companies filtered by their Status field value in a list.
Important: This tool performs client-side filtering since the Affinity API doesn't support server-side filtering by status. For large lists (>100 entries), use pagination parameters.
Parameters:
listId: List ID (required) - get from affinity_list_lists
swimlaneId: Swimlane/stage ID (required) - get from affinity_get_swimlanes (this is the dropdownOptionId)
cursor: Pagination cursor (optional)
limit: Items per page (default 100, max 100)
Returns (JSON): { "companies": [ { "id": number, "name": string, "domain": string, "isGlobal": boolean, "status": { "text": "Portfolio", "rank": 7, "color": "purple", "dropdownOptionId": number }, "listEntryId": number, "createdAt": string } ], "count": number, "swimlaneText": string, "listName": string, "hasMore": boolean }
Workflow:
Use affinity_list_lists to find lists
Use affinity_get_swimlanes to see available stages
Use this tool to get companies in a specific stage
Use Cases:
"Get all companies in the Lead stage"
"Show me portfolio companies"
"List companies in Meeting Scheduled stage"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| listId | Yes | List ID (numeric). Get from affinity_list_lists. | |
| swimlaneId | Yes | Swimlane/stage ID (numeric dropdownOptionId). Get from affinity_get_swimlanes. | |
| cursor | No | Pagination cursor from previous response | |
| limit | No | Items per page (default 100, max 100) | |
| responseFormat | No | Output format: "json" or "markdown". Default: "json" |