# list offers

`GET https://api.suger.cloud/org/{orgId}/offer`

List offers under the given organization with pagination and optional filter.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `status` | query | string | no | filter by offer status |
| `partner` | query | string | no | filter by partner |
| `offerType` | query | string | no | filter by offerType |
| `productId` | query | string | no | filter by productId |
| `buyerId` | query | string | no | filter by buyerId |
| `hubspotDealId` | query | string | no | filter by hubspot Deal ID |
| `salesforceOpportunityId` | query | string | no | filter by salesforce Opportunity ID |
| `dynamics365OpportunityId` | query | string | no | filter by Microsoft Dynamics 365 Opportunity ID (lowercased GUID, no braces) |
| `contactId` | query | string | no | filter by contactId |
| `channelType` | query | string | no | filter by channelType (DIRECT, RESALE) |
| `pricingType` | query | string | no | filter by pricingType (CONTRACT, CUD, FIXED_FEE, etc.) |
| `productType` | query | string | no | filter by productType (AMI, SAAS, CONTAINER, etc.) |
| `limit` | query | integer | no | List pagination size, default 1000, max value is 1000 |
| `offset` | query | integer | no | List pagination offset, default 0 |

## Responses

### 200 — OK

Content-Type: `application/json`

### 400 — Bad request error

Content-Type: `application/json`

### 405 — Method not allowed

Content-Type: `application/json`

### 500 — Internal server error

Content-Type: `application/json`

---

Interactive API reference: https://doc.suger.io/api/