---
title: "List opportunities"
method: GET
path: "/assistedSales/v1/opportunities"
tags: ["AppResellerOpportunities"]
---

# List opportunities

`GET /assistedSales/v1/opportunities`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/assistedSales/v1/opportunities`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/assistedSales/v1/opportunities/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of opportunities. Returned opportunities are limited to role visibility: 
 Marketplace Manager, Partner, Partner Read: all opportunities. 
 Reseller Manager: all opportunities owned by Reseller companies. 
 Reseller, SSR: all opportunities owned by the company to which the Reseller or SSR belongs. 
 When users have multiple roles, visibility is the sum of visibility for all their roles. 
 Additional filter parameters are available for some roles.

Required: Accept-Language header with Locale format. For example: en-US

## Query parameters

- `ownerId` string
- `ownerCompanyId` string
- `customerId` string
- `customerCompanyId` string
- `context` 'RESELLER' | 'SSR'
- `status` 'OPEN' | 'CLOSED' | 'PENDING_REVIEW'
- `purchaseEffectiveDate` string[]
- `createdOn` string[]
- `searchText` string
- `number` integer
- `size` integer
- `sort` string

## Response `200`

Success

- OpportunityPage
  - `page` PageMetadata
    - `number` number, required: Page number
    - `size` number, required: Size of the page to be returned
    - `totalElements` number, required: Total number of elements
    - `totalPages` number, required: Total number of pages
  - `content` OpportunityLight[]: List of opportunities
    - `id` string: Opportunity ID
    - `name` string: Opportunity name
    - `ownerUser` User
      - `id` string: User ID
      - `email` string: User email address
      - `firstName` string: User first name
      - `lastName` string: User last name
      - `company` object: User company
        - `id` string: Company ID
        - `name` string: Company name
        - `isReseller` boolean: Indicate if the company is reseller
    - `customerUser` User
      - `id` string: User ID
      - `email` string: User email address
      - `firstName` string: User first name
      - `lastName` string: User last name
      - `company` object: User company
        - `id` string: Company ID
        - `name` string: Company name
        - `isReseller` boolean: Indicate if the company is reseller
    - `createdOn` number: Opportunity creation date, in UNIX Epoch milliseconds
    - `purchaseEffectiveDate` number: Opportunity purchase effective date, in UNIX Epoch milliseconds
    - `status` 'OPEN' | 'CLOSED' | 'PENDING_REVIEW': Opportunity status
    - `ownerType` 'PARTNER' | 'PLATFORM_OWNER': Opportunity owner type code

## Other responses

- `403`: The user does not have permission to execute the action

## Changes

- **2026-11-06** `1fc240f06971`: 2 breaking, 7 info
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `object` for status `403`
  - added the new optional `query` request parameter `status`
  - added the optional property `content` to the response with the `200` status
  - …5 more

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/assistedSales/v1/opportunities/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)