---
title: "List offers for the authenticated partner"
method: GET
path: "/v1/offers"
tags: ["Offers"]
---

# List offers for the authenticated partner

`GET /v1/offers`

## Query parameters

- `starting_after` string
- `starting_before` string
- `limit` integer — A limit on the number of objects to be returned

## Response `200`

Successful response.

- object
  - `data` OfferSummary[], required
    - `banner_url` string, uri, required — The URL for the offer banner
    - `ends_at` string, date-time, nullable, required — When the offer ends. Null when the offer has no end date
    - `id` string, required — Unique identifier for the object.
    - `logo_url` string, uri, required — The URL for the offer logo
    - `object` 'offer', required — String representing the object's type. Objects of the same type share the same value.
    - `options` OfferOption[], required — List of offer options
      - `bid_increment` string, nullable, required — Decimal string
      - `floor_price_usd` string, nullable, required — Decimal string
      - `id` string, required — Unique identifier for the object.
      - `minimum_purchase_usd` string, nullable, required — Decimal string
      - `price_usd` string, nullable, required — Decimal string
      - `sale_agreement_url` string, nullable, required
      - `slug` string, required — The slug identifier of the option
      - `total_token_supply` integer, nullable, required — Total token supply in whole tokens
    - `slug` string, required — The slug identifier of the offer
    - `starts_at` string, date-time, required — When the offer starts
    - `tagline` string, required — Tagline text for the offer (English)
    - `type` 'sale' | 'swap', required — The type of the offer
  - `object` 'list', required — String representing the object's type. Objects of the same type share the same value.
  - `starting_after` string — String representing the page cursor to used for querying the next page.
  - `starting_before` string — String representing the page cursor to used for querying the previous page.

## Other responses

- `default` — Error response.

---

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