> ## Documentation Index
> Fetch the complete documentation index at: https://devs.elementpay.net/llms.txt
> Use this file to discover all available pages before exploring further.

# List orders for a wallet

> Returns only orders belonging to the API key's user for that wallet.

Pagination:
  - **limit**: maximum number of rows to return (default 50)
  - **offset**: number of rows to skip **before** starting to return results
                (combine with limit for offset-based pagination)

List orders for a wallet address.

**Auth & Scope**

* Internal keys: return all orders for the wallet.
* Regular developer keys: return only orders owned by the calling user for that wallet.

**Pagination**

* `limit` (default 50, max 200)
* `offset` (default 0)


## OpenAPI

````yaml api-reference/openapi.json get /orders/wallet
openapi: 3.1.0
info:
  title: Element Aggregator API for B2B
  description: >-
    The Element Aggregator acts as a bridge between fiat and blockchain smart
    contracts. It handles payment processing, event listening, and order
    management, ensuring seamless coordination between Web2 and Web3 ecosystems.
  version: 1.0.0
servers:
  - url: https://sandbox.elementpay.net
security: []
paths:
  /orders/wallet:
    get:
      tags:
        - Order Endpoints
      summary: List orders for a wallet
      description: |-
        Returns only orders belonging to the API key's user for that wallet.

        Pagination:
          - **limit**: maximum number of rows to return (default 50)
          - **offset**: number of rows to skip **before** starting to return results
                        (combine with limit for offset-based pagination)
      operationId: get_orders_for_wallet_orders_wallet_get
      parameters:
        - name: wallet_address
          in: query
          required: true
          schema:
            type: string
            title: Wallet Address
          description: The wallet address to check the orders for
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            description: Max rows per page
            default: 50
            title: Limit
          description: Max rows per page
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Rows to skip (for pagination)
            default: 0
            title: Offset
          description: Rows to skip (for pagination)
      responses:
        '200':
          description: Orders fetched successfully
          content:
            application/json:
              schema: {}
              examples:
                with_results:
                  summary: Found orders
                  value:
                    status: success
                    message: Orders fetched (2)
                    data:
                      - order_id: 95531bef5c8a3997d61f6721...
                        status: PENDING
                        wallet_address: '0x4f07419e6bfccf8d256e8ef803cc2653dfbb9558'
                        amount_crypto: 0.07536
                        amount_fiat: 10
                        currency: KES
                        exchange_rate: 132.6965
                        token: BASE_USDC(Testnet)
                        creation_transaction_hash: c69b5e...e6
                        webhook_url: https://example.com/webhook
                        order_type: OnRamp
                        created_at: '2025-08-13T04:38:34.000Z'
                      - order_id: a1b2c3d4...
                        status: SETTLED
                        wallet_address: '0x4f07419e6bfccf8d256e8ef803cc2653dfbb9558'
                        amount_crypto: 5
                        amount_fiat: 650
                        currency: KES
                        exchange_rate: 130
                        token: BASE_USDC(Testnet)
                        creation_transaction_hash: 0xabc...
                        settlement_transaction_hash: 0xdef...
                        webhook_url: https://example.com/webhook
                        order_type: OffRamp
                        created_at: '2025-08-10T10:00:00.000Z'
                empty:
                  summary: No orders
                  value:
                    status: success
                    message: Orders fetched (0)
                    data: []
        '400':
          description: Invalid wallet address
          content:
            application/json:
              example:
                status: error
                message: Invalid wallet address.
                data:
                  field: wallet_address
                  value: not-an-address
        '401':
          description: Unauthorized / Missing or invalid API key
          content:
            application/json:
              examples:
                Missing Api Key:
                  summary: No API key provided
                  value:
                    status: error
                    message: Missing API key
                    data: null
                Invalid Or RevokedApiKey:
                  summary: Invalid or revoked key
                  value:
                    status: error
                    message: Invalid or revoked API key
                    data: null
        '422':
          description: Validation error
          content:
            application/json:
              example:
                status: error
                message: Validation error
                data:
                  errors:
                    - type: missing
                      loc:
                        - query
                        - wallet_address
                      msg: Field required
        '500':
          description: Internal error
          content:
            application/json:
              example:
                status: error
                message: Internal error occurred
      security:
        - APIKeyHeader: []
components:
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````