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

# 列出订单

> Paginated list of the authenticated user's orders.



## OpenAPI

````yaml GET /customer/v2/orders
openapi: 3.0.3
info:
  title: OrbitFlare Customer API
  description: >-
    API documentation for the OrbitFlare Customer API. This API allows
    authenticated customers to manage their licenses, whitelist IPs, reset keys,
    and retrieve associated data. Supports v1 (API key only) and v2 (Bearer
    token or API key) with extended features including device/wallet auth, API
    keys management, profile, Solana USDC balance top-up, and RPC plan
    purchasing.
  version: 2.1.0
servers:
  - url: https://orbitflare.com/api
    description: OrbitFlare Production server
security:
  - api_key: []
tags:
  - name: Auth
    description: Authentication (device flow, wallet signature, session)
  - name: Licenses
    description: License management
  - name: API Keys
    description: API key management
  - name: Profile
    description: User profile and balance
  - name: Invoices
    description: Invoice listing, detail, and balance payment
  - name: Top-Up
    description: Balance top-up via Solana USDC
  - name: RPC Plans
    description: Solana RPC plan catalog
  - name: Orders
    description: Order management (validate, purchase, list)
paths:
  /customer/v2/orders:
    get:
      tags:
        - Orders
      summary: List Orders
      description: Paginated list of the authenticated user's orders.
      operationId: listOrders
      parameters:
        - name: per_page
          in: query
          description: Results per page (max 50, default 15).
          schema:
            type: integer
            default: 15
            maximum: 50
        - name: page
          in: query
          description: Page number.
          schema:
            type: integer
            default: 1
      responses:
        '200':
          description: Orders retrieved.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      orders:
                        type: object
                        properties:
                          data:
                            type: array
                            items:
                              $ref: '#/components/schemas/OrderSummary'
                          current_page:
                            type: integer
                          last_page:
                            type: integer
                          per_page:
                            type: integer
                          total:
                            type: integer
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2ErrorResponse'
      security:
        - bearer_token: []
        - api_key: []
components:
  schemas:
    OrderSummary:
      type: object
      properties:
        reference:
          type: string
        status:
          type: string
        payment_status:
          type: string
        product_name:
          type: string
          nullable: true
        product_slug:
          type: string
          nullable: true
        total_amount:
          type: number
          format: float
        billing_period:
          type: string
        placed_at:
          type: string
          format: date-time
          nullable: true
        fulfilled_at:
          type: string
          format: date-time
          nullable: true
    V2ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
        errors:
          type: object
        error:
          type: string
          description: Error code (e.g. authorization_pending, slow_down)
  securitySchemes:
    api_key:
      type: apiKey
      name: X-ORBIT-KEY
      in: header
      description: API key for v1 and v2 (when not using Bearer token)
    bearer_token:
      type: http
      scheme: bearer
      bearerFormat: Sanctum
      description: Bearer token from device or wallet auth

````