---
title: "List loyalty orders"
method: GET
path: "/v1/loyalty/orders"
tags: ["Loyalty"]
---

# List loyalty orders

`GET /v1/loyalty/orders`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/loyalty/orders`
- Auth: API key in header `X-Api-Key`

Retrieve order history for a loyalty account wallet. Organization members can only access wallets from their organization. An order_transaction may be transiently omitted from the response if the indexer has not yet hydrated its underlying asset transfer.

## Query parameters

- `walletId` string, required
- `sorters` object[]
  - `field` 'id' | 'createdAt' | 'price', required
  - `order` 'asc' | 'desc', required
- `currentPage` integer
- `pageSize` integer

## Response `200`

- PaginatedLoyaltyOrderDto
  - `data` object[], required: Array of items for the current page
    - `id` string, required
    - `createdAt` string, date-time, required
    - `price` string, required
    - `items` unknown[], required
      - unknown
    - `orderTransactions` object, required
      - `nodes` object[], required
        - `assetTransfer` object, required
          - `id` string, required
          - `fromId` string, required
          - `toId` string, required
          - `value` string, required
          - `decimals` number, required
          - `transaction` object, required
            - `id` string, required
            - `blockNumber` string, required
            - `date` string, date-time, required
  - `total` integer, required: Total count of items matching the query
  - `limit` integer, required: Number of items per page (max 5000 for client-side pagination)

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)