---
title: "List Quotes"
method: GET
path: "/v2/quote"
---

# List Quotes

`GET /v2/quote`

List quotes for the application, optionally filtered by customer ID and/or status.

## Query parameters

- `page` string, required
- `limit` string, required
- `customerId` string
- `status` 'active' | 'used' | 'expired'

## Response `200`

- ListQuotesResponseDto
  - `page` number, required — Current page number
  - `limit` number, required — Number of items per page
  - `total` number, required — Total number of items
  - `totalPages` number, required — Total number of pages
  - `hasNext` boolean, required — Whether there is a next page
  - `hasPrevious` boolean, required — Whether there is a previous page
  - `data` object[], required — The list of quotes for the current page.
    - `id` string, required — A unique identifier for the quote.
    - `status` 'active' | 'used' | 'expired', required — The current status of the quote.
    - `type` 'on_ramp' | 'off_ramp', required — The transfer type this quote is for.
    - `customerId` string, required — The customer ID.
    - `fees` object, required
      - `integratorFee` object, required — The integrator fee portion.
        - `fixedAmount` string, required — The fixed amount of the fee.
        - `bpsRate` string, required — The BPS rate of the fee.
        - `bpsAmount` string, required — The dollar amount of the BPS-based fee component (sourceAmount * bpsRate / 10000).
        - `totalAmount` string, required — The total amount of the fee applied to the source amount.
        - `currency` union, required — The currency of the fee.
          - 'usdc' | 'usdt' | 'eurc'
          - 'usd' | 'eur' | 'brl'
      - `platformFee` object, required — The platform fee portion.
        - `fixedAmount` string, required — The fixed amount of the fee.
        - `bpsRate` string, required — The BPS rate of the fee.
        - `bpsAmount` string, required — The dollar amount of the BPS-based fee component (sourceAmount * bpsRate / 10000).
        - `totalAmount` string, required — The total amount of the fee applied to the source amount.
        - `currency` union, required — The currency of the fee.
          - 'usdc' | 'usdt' | 'eurc'
          - 'usd' | 'eur' | 'brl'
    - `source` object, required
      - `currency` union, required — The source currency.
        - 'usdc' | 'usdt' | 'eurc'
        - 'usd' | 'eur' | 'brl'
      - `network` union, required — The source network.
        - 'sol' | 'fogo' | 'ethereum' | 'arbitrum' | 'polygon' | 'base' | 'avalanche' | 'sui' | 'noble' | 'sei' | 'tron' | 'starknet' | 'aptos' | 'hyperliquid' — A blockchain network.
        - 'wire' | 'ach' | 'achPush' | 'achPull' | 'achSameDay' | 'swift' | 'sepa' | 'pix'
      - `amount` string, required — The source amount.
    - `destination` object, required
      - `currency` union, required — The destination currency.
        - 'usdc' | 'usdt' | 'eurc'
        - 'usd' | 'eur' | 'brl'
      - `network` union, required — The destination network.
        - 'sol' | 'fogo' | 'ethereum' | 'arbitrum' | 'polygon' | 'base' | 'avalanche' | 'sui' | 'noble' | 'sei' | 'tron' | 'starknet' | 'aptos' | 'hyperliquid' — A blockchain network.
        - 'wire' | 'ach' | 'achPush' | 'achPull' | 'achSameDay' | 'swift' | 'sepa' | 'pix'
      - `amount` string, required — The destination amount after exchange.
      - `exchangeRate` string, required — The exchange rate applied to convert source to destination.
    - `expiresAt` string, date-time, required — The datetime when this quote expires.
    - `created` string, date-time, required — The datetime the quote was created.
    - `updated` string, date-time, required — The datetime the quote was last updated.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Unprocessable Entity - Validation Error

---

[API](https://skmtc.net/spherepay/apis/docs-spherepay-co.md) · [All operations](https://skmtc.net/spherepay/apis/docs-spherepay-co/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spherepay/docs-spherepay-co/versions/4f3f5484aed3/schema)