---
title: "GET /Opportunity"
method: GET
path: "/Opportunity"
tags: ["Opportunity"]
---

# GET /Opportunity

`GET /Opportunity`

List Opportunity records.

## Headers

- `X-No-Total` 'true' | 'false'

## Response `200`

Success.

- object
  - `list` Opportunity[] — Records.
    - `id` string — An ID.
    - `name` string — A one-line string.
    - `amount` number — A currency amount.
    - `amountCurrency` 'USD' — A code.
    - `amountConverted` number, nullable — A currency amount converted to the default currency.
    - `amountWeightedConverted` number, nullable
    - `accountId` string, nullable — An ID of the record of the Account type.
    - `accountName` string, nullable — A foreign record name.
    - `contactsIds` string[], nullable — IDs of records of the Contact type.
    - `contactsNames` object, nullable — An {ID => record name} map.
    - `contactsColumns` object, nullable — An {ID => object} map. Relationship column values.
    - `contactId` string, nullable — An ID of the record of the Contact type.
    - `contactName` string, nullable — A foreign record name.
    - `stage` 'Prospecting' | 'Qualification' | 'Proposal' | 'Negotiation' | 'Closed Won' | 'Closed Lost'
    - `lastStage` string
    - `probability` integer, nullable
    - `leadSource` 'Call' | 'Email' | 'Existing Customer' | 'Partner' | 'Public Relations' | 'Web Site' | 'Campaign' | 'Other', nullable
    - `closeDate` string, date — A date.
    - `description` string, nullable — A multi-line text.
    - `campaignId` string, nullable — An ID of the record of the Campaign type.
    - `campaignName` string, nullable — A foreign record name.
    - `originalLeadId` string, nullable — An ID of the record of the Lead type.
    - `originalLeadName` string, nullable — A foreign record name.
    - `contactRole` 'Decision Maker' | 'Evaluator' | 'Influencer', nullable
    - `createdAt` string, nullable — A timestamp in UTC.
    - `modifiedAt` string, nullable — A timestamp in UTC.
    - `createdById` string, nullable — An ID of the record of the User type.
    - `createdByName` string, nullable — A foreign record name.
    - `modifiedById` string, nullable — An ID of the record of the User type.
    - `modifiedByName` string, nullable — A foreign record name.
    - `assignedUserId` string, nullable — An ID of the record of the User type.
    - `assignedUserName` string, nullable — A foreign record name.
    - `teamsIds` string[], nullable — IDs of records of the Team type.
    - `teamsNames` object, nullable — An {ID => record name} map.
    - `streamUpdatedAt` string, nullable — A timestamp in UTC.
  - `total` number — The total number of records. If the total number is disabled, special values are returned: -1 – there are more records to paginate, -2 – there are no more records.

## Other responses

- `400` — Bad request. Check logs for details.
- `403` — Forbidden. Might be an access control error. Check logs for details.

## Changes

- **2025-12-02** `e28ba9216fac` — 9 warning, 2 info
  - deleted the `query` request parameter `attributeSelect`
  - deleted the `query` request parameter `boolFilterList`
  - deleted the `query` request parameter `maxSize`
  - deleted the `query` request parameter `offset`
  - …7 more

[Change history](https://skmtc.dev/espocrm/apis/espocrm-api/changes/Opportunity/get.md)

---

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