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

# List orders

> Paginated order list for the authenticated partner.

Filters: `status`, `type`, `network_identifier`, `crypto_currency_symbol`, `fiat_currency_code`, `customer_reference`, `date_from`, `date_to` (`DD/MM/YYYY`), `page`, `perPage`.




## OpenAPI

````yaml /openapi/partner-api.yaml get /v1/orders
openapi: 3.1.0
info:
  title: Liquidramp Partner API
  version: 2.0.0
  license:
    name: Proprietary
  description: >
    Public integration API for consumer partners: reference data, exchange
    rates, quotes, orders, and webhooks.


    ## Authentication


    - **Public key (`pk_*`)**: read requests (reference data, rate preview) — no
    HMAC

    - **Secret key (`sk_*`)**: backend only — reads and writes (quotes, orders,
    fulfilment). Every `sk_*` request requires HMAC signing with your `enc_*`
    encryption key


    Create keys in the [partner portal](https://dashboard.liquidramp.com). Never
    send `enc_*` as a Bearer token. Never use `sk_*` or `enc_*` in client-side
    code.


    ## HMAC canonical string


    `clientId|timestamp|METHOD|path|rawBody`


    Path includes the `/v1` prefix and any query string. Signature: `sha256=` +
    HMAC-SHA256(canonical, `enc_*`).
servers:
  - url: https://vibe-api.liquidramp.com
    description: Test
  - url: https://api.liquidramp.com
    description: Live
security: []
tags:
  - name: Health
    description: Service health checks
  - name: Reference
    description: Institutions, networks, currencies, and account lookup
  - name: Exchange Rates
    description: Market rates and quote preview
  - name: Orders
    description: Quotes, order creation, fulfilment, and management
  - name: Webhooks
    description: Outbound order lifecycle events delivered to your server
paths:
  /v1/orders:
    get:
      tags:
        - Orders
      summary: List orders
      description: >
        Paginated order list for the authenticated partner.


        Filters: `status`, `type`, `network_identifier`,
        `crypto_currency_symbol`, `fiat_currency_code`, `customer_reference`,
        `date_from`, `date_to` (`DD/MM/YYYY`), `page`, `perPage`.
      operationId: listOrders
      parameters:
        - name: status
          in: query
          schema:
            $ref: '#/components/schemas/OrderStatus'
        - name: type
          in: query
          schema:
            $ref: '#/components/schemas/OrderType'
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
        - name: perPage
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: customer_reference
          in: query
          schema:
            type: string
        - name: network_identifier
          in: query
          schema:
            type: string
        - name: crypto_currency_symbol
          in: query
          schema:
            type: string
        - name: fiat_currency_code
          in: query
          schema:
            type: string
        - name: date_from
          in: query
          schema:
            type: string
          description: Start date (`DD/MM/YYYY`)
          example: 01/06/2026
        - name: date_to
          in: query
          schema:
            type: string
          description: End date (`DD/MM/YYYY`)
          example: 30/06/2026
      responses:
        '200':
          description: Order list
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SuccessEnvelope'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/OrderList'
                      meta:
                        $ref: '#/components/schemas/PaginationMeta'
      security:
        - SecretKeyHmac: []
components:
  schemas:
    OrderStatus:
      type: string
      enum:
        - initiated
        - pending
        - processing
        - settled
        - awaiting_user_payment
        - awaiting_lp_payment
        - routing
        - executing
        - partially_completed
        - completed
        - cancelled
        - expired
        - failed
        - refunded
        - reverted
    OrderType:
      type: string
      enum:
        - onramp
        - offramp
        - swap
    SuccessEnvelope:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: boolean
          const: true
        message:
          type: string
        data: {}
        meta:
          $ref: '#/components/schemas/PaginationMeta'
    OrderList:
      type: object
      properties:
        reference:
          type: string
        merchant_reference:
          type:
            - string
            - 'null'
        customer_reference:
          type:
            - string
            - 'null'
        type:
          $ref: '#/components/schemas/OrderType'
        from:
          $ref: '#/components/schemas/OrderLeg'
        to:
          $ref: '#/components/schemas/OrderLeg'
        pricing:
          $ref: '#/components/schemas/OrderPricing'
        fee:
          $ref: '#/components/schemas/OrderFee'
        metadata:
          type:
            - object
            - 'null'
        amount_paid:
          type: number
        amount_settled:
          type: number
        amount_refunded:
          type: number
        percentage_settled:
          type: number
        status:
          $ref: '#/components/schemas/OrderStatus'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    PaginationMeta:
      type: object
      properties:
        total:
          type: integer
        per_page:
          type: integer
        current_page:
          type: integer
        last_page:
          type: integer
    OrderLeg:
      type: object
      properties:
        currency:
          type: string
        network:
          type: string
        amount:
          type: number
    OrderPricing:
      type: object
      properties:
        base_currency:
          type: string
        quote_currency:
          type: string
        exchange_rate:
          type: number
    OrderFee:
      type: object
      properties:
        currency:
          type: string
        network_fee:
          type: number
        protocol_fee:
          type: number
        partner_fee:
          type: number
        vat:
          type: number
        total:
          type: number
        fee_in_rate:
          type: boolean
      description: >-
        Omitted from responses when the fee is already embedded in
        `pricing.exchange_rate`.
  securitySchemes:
    SecretKeyHmac:
      type: http
      scheme: bearer
      description: |
        Bearer sk_* plus required headers:
        - liquidramp-client-id
        - liquidramp-timestamp (unix ms)
        - liquidramp-signature (sha256=...)

````