List Companies
affinity_list_companiesRetrieve company records from Affinity CRM with optional enriched or custom field data, filter by IDs, and paginate results.
Instructions
List companies (organizations) from Affinity CRM.
Returns company records with optional field data. Without fieldTypes parameter, returns only basic info (id, name, domain, domains, isGlobal).
Field Types:
enriched: Data from Affinity Data and Dealroom (description, employees, funding, location, LinkedIn, industry, etc.)
global: Your account's custom company fields
Important Notes:
This endpoint does NOT support text/name filtering
To find specific companies: use the 'ids' parameter with known company IDs
To search/filter companies: use Saved Views via affinity_get_list_entries
Returns max 100 companies per request; use cursor for pagination
Returns (JSON): { "data": [ { "id": number, // Company ID "name": string, // Company name "domain": string, // Primary domain "domains": string[], // All domains "isGlobal": boolean, // Is shared record "fields": [...] // Field data (if requested) } ], "count": number, // Items in response "hasMore": boolean, // More results available "nextCursor": string|null, // Pagination cursor "summary": string // Human-readable summary }
Example enriched fields returned:
affinity-data-description (company description)
affinity-data-number-of-employees (employee count)
affinity-data-location (city, state, country)
affinity-data-total-funding-amount (USD)
affinity-data-linkedin-url
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Filter by specific company IDs. Example: [1514108, 279041073] | |
| fieldTypes | No | Field categories to include. Options: "enriched" (Affinity Data, Dealroom), "global" (custom fields). Without this, no field data is returned. | |
| fieldIds | No | Specific field IDs to return. Example: ["affinity-data-description", "affinity-data-location"] | |
| limit | No | Number of companies to return per page. Default: 100, Max: 100 | |
| cursor | No | Pagination cursor from previous response (pagination.nextPageToken) | |
| responseFormat | No | Output format: "json" for structured data or "markdown" for human-readable. Default: "json" |