---
title: "Get all List Entries on a Saved View"
method: GET
path: "/v2/lists/{listId}/saved-views/{viewId}/list-entries"
tags: ["Lists"]
---

# Get all List Entries on a Saved View

`GET /v2/lists/{listId}/saved-views/{viewId}/list-entries`

Paginate through the List Entries (AKA rows) on a given Saved View.
Use this endpoint when you need to filter entities or only want **some**
field data to be returned: This endpoint respects the filters set on a Saved View
via web app, and only returns field data corresponding to the columns that have been
pulled into the Saved View via web app.

Though this endpoint respects the Saved View's filters and column/Field selection,
it does not yet preserve sort order. This endpoint also only supports **sheet-type
Saved Views**, and not board- or dashboard-type Saved Views.

See the [Data Model](/pages/data-model/the-basics) section for more information about Saved Views.

Requires the "Export data from Lists" [permission](/pages/external-api-v2/permissions).

## Path parameters

- `listId` integer, required
- `viewId` integer, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

OK

- ListEntryWithEntityPaged — ListEntryWithEntityPaged model
  - `data` ListEntryWithEntity[], nullable, required — A page of ListEntryWithEntity results
    - union
      - CompanyListEntry
        - `id` integer, required — The list entry's unique identifier
        - `type` 'company', required — The entity type for this list entry
        - `listId` integer, required — The ID of the list that this list entry belongs to
        - `createdAt` string, date-time, required — The date that the list entry was created
        - `creatorId` integer, nullable, required — The ID of the user that created this list entry
        - `entity` Company, required — Company model
          - `id` integer, required — The company's unique identifier
          - `name` string, required — The company's name
          - `domain` string, hostname, nullable, required — The company's primary domain
          - `domains` string[], required — All of the company's domains
          - `isGlobal` boolean, required — Whether or not the company is tenant specific
          - `fields` Field[] — The fields associated with the company
            - `id` string, required — The field's unique identifier
            - `name` string, required — The field's name
            - `type` 'enriched' | 'global' | 'list' | 'relationship-intelligence' | 'hidden', required — The field's category. `hidden` is a redaction state rather than a category: it signals a field on a restricted opportunity the caller cannot manage, whose value is masked.
            - `enrichmentSource` 'affinity-data' | 'dealroom' | 'eventbrite' | 'mailchimp' | 'null', nullable, required — The source of the data in this Field (if it is enriched)
            - `value` union, required
              - …
      - OpportunityListEntry
        - `id` integer, required — The list entry's unique identifier
        - `type` 'opportunity', required — The entity type for this list entry
        - `listId` integer, required — The ID of the list that this list entry belongs to
        - `createdAt` string, date-time, required — The date that the list entry was created
        - `creatorId` integer, nullable, required — The ID of the user that created this list entry
        - `entity` OpportunityWithFields, required — Opportunity model including the opportunity's fields.
          - `id` integer, required — The unique identifier for the opportunity
          - `name` string, required — The name of the opportunity.
          - `listId` integer, required — The ID of the list that the opportunity belongs to
          - `fields` Field[] — The fields associated with the opportunity. Empty for a redacted opportunity.
            - `id` string, required — The field's unique identifier
            - `name` string, required — The field's name
            - `type` 'enriched' | 'global' | 'list' | 'relationship-intelligence' | 'hidden', required — The field's category. `hidden` is a redaction state rather than a category: it signals a field on a restricted opportunity the caller cannot manage, whose value is masked.
            - `enrichmentSource` 'affinity-data' | 'dealroom' | 'eventbrite' | 'mailchimp' | 'null', nullable, required — The source of the data in this Field (if it is enriched)
            - `value` union, required
              - …
          - `isRestricted` boolean, required — Whether the opportunity is restricted. `false` for customers without the Restricted Opportunities feature enabled.
          - `isRedacted` boolean, required — Whether the response is redacted because the requesting user does not have access to sensitive details of this restricted opportunity. When `true`, `fields` is empty. Always `false` when `isRestricted` is `false`.
      - PersonListEntry
        - `id` integer, required — The list entry's unique identifier
        - `type` 'person', required — The entity type for this list entry
        - `listId` integer, required — The ID of the list that this list entry belongs to
        - `createdAt` string, date-time, required — The date that the list entry was created
        - `creatorId` integer, nullable, required — The ID of the user that created this list entry
        - `entity` Person, required — Person model
          - `id` integer, required — The persons's unique identifier
          - `firstName` string, required — The person's first name
          - `lastName` string, nullable, required — The person's last name
          - `primaryEmailAddress` string, email, nullable, required — The person's primary email address
          - `emailAddresses` string[], required — All of the person's email addresses
          - `type` 'internal' | 'external', required — The person's type. `internal` - people who are users within your Affinity instance. `external` - people who are not internal.
          - `fields` Field[] — The fields associated with the person
            - `id` string, required — The field's unique identifier
            - `name` string, required — The field's name
            - `type` 'enriched' | 'global' | 'list' | 'relationship-intelligence' | 'hidden', required — The field's category. `hidden` is a redaction state rather than a category: it signals a field on a restricted opportunity the caller cannot manage, whose value is masked.
            - `enrichmentSource` 'affinity-data' | 'dealroom' | 'eventbrite' | 'mailchimp' | 'null', nullable, required — The source of the data in this Field (if it is enriched)
            - `value` union, required
              - …
  - `pagination` Pagination, required
    - `prevUrl` string, uri, nullable — URL for the previous page
    - `nextUrl` string, uri, nullable — URL for the next page

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `default` — Errors

---

[API](https://skmtc.dev/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.dev/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)