> ## 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 my orders

**Use this to power your “My Orders” screen.**

**Filters**

* `status` (enum): pending, failed, settled, settled\_unverified, refunded
* `order_type` (enum): onramp, offramp
* `limit` (default 50, max 200)
* `offset` (default 0)

**Pagination**
Use `limit` and `offset` for offset-based pagination. For example, page 2 with page size 50 ⇒ `limit=50&offset=50`.

**Auth**
Requires `X-API-Key`. Returns only orders owned by the key's user.


## OpenAPI

````yaml api-reference/openapi.json get /orders/me
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/me:
    get:
      tags:
        - Order Endpoints
      summary: List orders for the authenticated user
      operationId: get_my_orders_orders_me_get
      parameters:
        - name: status_filter
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/OrderStatus'
              - type: 'null'
            description: Filter by order status
            title: Status Filter
          description: Filter by order status
        - name: order_type
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/OrderTypeQuery'
              - type: 'null'
            description: Filter by order type
            title: Order Type
          description: Filter by order type
        - 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: >-
                          95531bef5c8a3997d61f672193b73c458455b3d1649f37ec356e9db45676bc3c
                        status: PENDING
                        amount_crypto: 0.07536
                        amount_fiat: 10
                        currency: KES
                        exchange_rate: 132.6965
                        token: BASE_USDC(Testnet)
                        file_id: EPay-95531bef5c
                        phone_number: '254712345678'
                        creation_transaction_hash: >-
                          c69b5efb9852adcad851b8a7d778f922151a655d3cf04ebbc239202423bac6e6
                        order_type: OnRamp
                        wallet_address: '0x4f07419e6bfccf8d256e8ef803cc2653dfbb9558'
                        created_at: '2025-08-13T04:38:34.976Z'
                      - order_id: a1b2c3d4e5f6...
                        status: SETTLED
                        amount_crypto: 5
                        amount_fiat: 650
                        currency: KES
                        exchange_rate: 130
                        token: BASE_USDC(Testnet)
                        invoice_id: INV-12345
                        creation_transaction_hash: 0xabc...
                        settlement_transaction_hash: 0xdef...
                        order_type: OffRamp
                        wallet_address: '0x4f07419e6bfccf8d256e8ef803cc2653dfbb9558'
                        created_at: '2025-08-10T10:00:00.000Z'
                        updated_at: '2025-08-10T10:30:00.000Z'
                empty:
                  summary: No orders
                  value:
                    status: success
                    message: Orders fetched (0)
                    data: []
        '401':
          description: Unauthorized / Missing or invalid API key
          content:
            application/json:
              example:
                status: error
                message: Not authenticated
        '422':
          description: >-
            Validation error (e.g., bad query params:
            status/order_type/limit/offset)
          content:
            application/json:
              examples:
                bad_status:
                  summary: Unsupported status value
                  value:
                    status: error
                    message: Validation error
                    data:
                      errors:
                        - type: value_error
                          loc:
                            - query
                            - status
                          msg: Unexpected value
                          input: DONE
                bad_pagination:
                  summary: Invalid pagination
                  value:
                    status: error
                    message: Validation error
                    data:
                      errors:
                        - type: value_error.number.not_ge
                          loc:
                            - query
                            - limit
                          msg: Input should be greater than or equal to 1
                          input: 0
                        - type: value_error.number.not_ge
                          loc:
                            - query
                            - offset
                          msg: Input should be greater than or equal to 0
                          input: -1
        '500':
          description: Internal error
          content:
            application/json:
              example:
                status: error
                message: Internal error occurred
      security:
        - APIKeyHeader: []
components:
  schemas:
    OrderStatus:
      type: string
      enum:
        - pending
        - failed
        - settled
        - settled_unverified
        - refunded
      title: OrderStatus
    OrderTypeQuery:
      type: string
      enum:
        - onramp
        - offramp
      title: OrderTypeQuery
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````