---
title: "List all offers for a wallet"
method: GET
path: "/v2/wallets/{walletId}/offers"
tags: ["Canton Offers"]
---

# List all offers for a wallet

`GET /v2/wallets/{walletId}/offers`

Retrieve all Canton offers associated with a specific wallet. Offers can be filtered by creation date and limited by count.

## Path parameters

- `walletId` string, uuid, required

## Query parameters

- `limit` string
- `createdBefore` string, date
- `createdAfter` string, date

## Response `200`

Success

- AllCantonOffersObject
  - `count` integer — Number of offers returned
  - `records` CantonOfferObject[]
    - `id` string, uuid — Unique identifier for the Canton offer
    - `status` 'RECEIVED' | 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'WITHDRAWN' | 'EXPIRED' — Current status of the offer
    - `amount` string — The amount of the offer
    - `currency` 'usdcx' — The currency of the offer
    - `source` object
      - `party` string — The party created the offer
    - `destination` object
      - `userId` string, uuid — The user ID receiving the offer
      - `userWalletId` string, uuid — The wallet ID receiving the offer
      - `party` string — The party receiving the offer
    - `creationTransactionHash` string — The transaction hash when the offer was created
    - `executionTransactionHash` string, nullable — The transaction hash when the offer was accepted or rejected (null if not yet executed)
    - `createdAt` string, date-time — Timestamp when the offer was created
    - `updatedAt` string, date-time — Timestamp when the offer was last updated
    - `expiresAt` string, date-time, nullable — Timestamp when the offer expires (null if no expiration)
  - `nextCursor` string, nullable — The `createdAt` timestamp of the last record in the current page. Pass this as `createdBefore` in the next request to retrieve the next page of results. Null if there are no more records.

## Other responses

- `400` — Field Validation Error
- `401` — Unauthorized
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/hifi/apis/hifi-api.md) · [All operations](https://skmtc.net/hifi/apis/hifi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hifi/hifi-api/versions/15a39c342fd1/schema)