Get List Entries
affinity_get_list_entriesGet rows from an Affinity list with field values for companies, people, or opportunities. Supports pagination and field filtering.
Instructions
Get entries (rows) from a specific Affinity list.
Each entry represents a company, person, or opportunity on the list with its field values.
Returns (JSON): { "data": [ { "id": number, // Entry ID (unique within this list) "listId": number, // The list this entry belongs to "creatorId": number, // User who added the entry "type": string, // "company", "person", or "opportunity" "createdAt": string, // When entry was added (ISO timestamp) "entity": { "id": number, // Company/Person/Opportunity ID "name": string, // Entity name "domain": string, // Domain (for companies) "isGlobal": boolean, // Is shared record "fields": [ // Field values (if requested) { "id": string, "type": string, "name": string, "value": { "type": string, "data": any } } ] } } ], "count": number, // Items in response "hasMore": boolean, // More results available "nextCursor": string|null, // Pagination cursor "summary": string // Human-readable summary }
Field Types:
enriched: Affinity Data fields (description, employees, funding, etc.)
global: Account-wide custom fields
list: List-specific fields (Status, Amount, Owners, Priority, etc.)
Important: Fields are nested inside entity.fields, not at the entry level.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| listId | Yes | List ID (numeric). Get from affinity_list_lists. Example: "95303" | |
| fieldTypes | No | Field categories to include. Options: "enriched", "global", "list" (list-specific fields like Status, Amount). Without this, no field data is returned. | |
| fieldIds | No | Specific field IDs to return. Example: ["field-1022243", "affinity-data-description"] | |
| limit | No | Number of entries 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" |