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

# List Orders

> Returns a paginated list of onramp orders for your project, newest first by default. Use `nextCursor` or `previousCursor` from the response to page through results.

Use this endpoint to track purchases through the onramp lifecycle: quote, payment (including KYC and recipient verification for external wallets), delivery, and completed. Filter by `paymentStatus` and `deliveryStatus` to surface orders at each stage.

Optional filters accept comma-separated values (maximum 20 terms per filter). Keep the same filter params when following cursors.

**API scope required**: `orders.read`



## OpenAPI

````yaml get /2022-06-09/orders
openapi: 3.0.0
info:
  contact:
    email: support@crossmint.com
    name: Crossmint Support
    url: https://www.crossmint.com
  description: Crossmint Checkout API
  title: Crossmint Checkout API
  version: 1.0.0
servers:
  - description: Staging environment (testnets)
    url: https://staging.crossmint.com/api
  - description: Production environment (mainnets)
    url: https://www.crossmint.com/api
security: []
tags: []
paths:
  /2022-06-09/orders:
    get:
      tags:
        - Headless Checkout Orders
      summary: List Orders (cursor-paginated)
      description: >-
        List orders for a project with cursor-based pagination. Use `nextCursor`
        / `previousCursor` from the response to page forward/backward.
      operationId: HeadlessCheckoutOrdersController-listOrders-2
      parameters:
        - in: query
          name: cursor
          required: false
          schema:
            type: string
        - in: query
          name: limit
          required: false
          schema:
            type: string
        - in: query
          name: sort
          required: false
          schema:
            default: desc
            enum:
              - asc
              - desc
            type: string
        - in: query
          name: paymentStatus
          required: false
          schema:
            type: array
        - in: query
          name: deliveryStatus
          required: false
          schema:
            type: array
        - in: query
          name: paymentMethod
          required: false
          schema:
            type: array
        - in: query
          name: recipientAddress
          required: false
          schema:
            type: array
        - in: query
          name: orderId
          required: false
          schema:
            type: array
      responses:
        '200':
          description: Orders retrieved successfully

````