---
search:
  tags:
    - Operations
    - GET
seo:
  description: >-
    Search and list offers with optional filtering by status, search term, and
    pagination. Reference for the GET / endpoint in the Offers API.
sidebar:
  label: Get offers
  badge: GET
title: Get offers
type: openapi-operation
---
Search and list offers with optional filtering by status, search term, and pagination.

`GET /`

**Responses**

- `200` — Offers retrieved successfully
- `401` — Unauthorized - Missing or invalid authentication
- `403` — Forbidden - The presented token does not carry the required scope
- `500` — Internal server error

Response example, 200:

```json
{
  "offers": [
    {
      "id": "string",
      "status": "pending",
      "thirdPartyId": "string"
    }
  ],
  "totalCount": 0,
  "statuses": [
    {
      "status": "pending",
      "count": 0
    }
  ],
  "pageInfo": {
    "hasNextPage": true,
    "hasPreviousPage": true
  }
}
```

Response example, 401:

```json
{
  "code": "UNAUTHORIZED",
  "message": "Missing authentication token"
}
```

Response example, 403:

```json
{
  "code": "INSUFFICIENT_SCOPE",
  "message": "The presented token is missing the `read:offers` scope, which this endpoint requires. Create a token with the scopes you need at https://developer.sibipro.com."
}
```

Response example, 500:

```json
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred"
}
```