---
title: "List sales opportunities"
method: GET
path: "/crm/sales/opportunities"
tags: ["Sales CRM"]
---

# List sales opportunities

`GET /crm/sales/opportunities`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/crm/sales/opportunities`
- Auth: HTTP bearer

Requires `crm:sales:read`.

## Query parameters

- `limit` integer
- `cursor` string
- `stageId` string
- `status` string
- `group` string
- `includeTotal` boolean

## Response `200`

Success

- SalesOpportunities
  - `opportunities` SalesOpportunity[]
    - `opportunityId` string, required
    - `leadId` string
    - `conversationId` string
    - `displayName` string
    - `channel` string
    - `version` integer
    - `revision` integer, required
    - `stageId` string
    - `stageLocked` boolean
    - `status` 'open' | 'won' | 'lost'
    - `summary` string
    - `values` object
    - `createdAt` string
    - `updatedAt` string
    - `closedAt` string
  - `hasMore` boolean
  - `nextCursor` string, nullable
  - `pipelineVersion` integer
  - `total` integer

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)