---
title: "Get all Opportunities"
method: GET
path: "/v2/opportunities"
tags: ["Opportunities"]
---

# Get all Opportunities

`GET /v2/opportunities`

Paginate through Opportunities in Affinity.
Returns basic information but **not** field data on each Opportunity.

To access field data on Opportunities, use the `/lists/{list_id}/list-entries`
or the `/v2/lists/{list_id}/saved-views/{view_id}/list-entries` GET endpoint.

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

## Query parameters

- `cursor` string
- `limit` integer
- `ids` integer[]

## Response `200`

OK

- OpportunityPaged — OpportunityPaged model
  - `data` Opportunity[], required — A page of Opportunity results
    - `id` integer, required — The unique identifier for the opportunity
    - `name` string, required — The name of the opportunity. When `isRedacted` is `true`, the real name is masked and this value is the literal string `[Hidden]`.
    - `listId` integer, required — The ID of the list that the opportunity belongs to
    - `listName` string, required — The name of the list that the opportunity belongs to
    - `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 this restricted opportunity. The real name is masked as `[Hidden]` when `true`. Always `false` when `isRestricted` is `false`.
  - `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.net/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.net/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/versions/4c2891c31b7f/schema)