---
title: "Retrieve offers"
method: GET
path: "/offers"
tags: ["Offers"]
---

# Retrieve offers

`GET /offers`

This endpoint is used to retrieve a list of offers. When used without query params, it will fetch all non-expired offers. Query params can be used to include expired offers, or to filter this set.

## Query parameters

- `includeExpired` boolean
- `nftId` string
- `collection` string
- `creator` string

## Response `200`

A list of offers

- Offer[]
  - `offer` OfferStruct
    - `minimumPrincipalPerPeriod` string
    - `periodDuration` integer
    - `creator` string
    - `nftContractAddress` string
    - `price` string
    - `periodInterestRateBps` integer
    - `nftId` string
    - `expiration` integer
    - `downPaymentAmount` string
    - `collectionOfferLimit` string
  - `signature` string
  - `createdAt` integer
  - `status` 'ACTIVE' | 'EXPIRED' | 'CANCELLED' | 'USED_TO_EXECUTE_LOAN' | 'COLLECTION_OFFER_LIMIT_REACHED'
  - `isCollectionOffer` boolean
  - `howManyTimesUsed` integer

## Other responses

- `400` — Bad request (invalid query)

---

[API](https://skmtc.net/niftyapes/apis/niftyapes-seller-financing-api.md) · [All operations](https://skmtc.net/niftyapes/apis/niftyapes-seller-financing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/niftyapes/niftyapes-seller-financing-api/revisions/e3581eb2919f/schema)