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

# List All Rate-Locked Quotes for Your Account

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

Retrieve a paginated list of all quotes created by your application. Useful for auditing past rate locks, building a history view in your UI, or finding the most recent active quote for a customer.


## OpenAPI

````yaml openapi/spherepay.yaml GET /v2/quote
openapi: 3.0.0
info:
  title: ''
  description: ''
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.spherepay.co
    description: Production
security:
  - bearer: []
tags: []
paths:
  /v2/quote:
    get:
      summary: List Quotes
      description: >-
        List quotes for the application, optionally filtered by customer ID
        and/or status.
      parameters:
        - name: page
          required: true
          in: query
          description: 'Page number of the list (default: 1)'
          schema:
            default: '1'
            example: 1
            type: string
        - name: limit
          required: true
          in: query
          description: 'Number of items per page (default: 10)'
          schema:
            default: '10'
            example: 10
            type: string
        - name: customerId
          required: false
          in: query
          description: Filter quotes by customer ID.
          schema:
            pattern: ^customer_[a-z0-9]+$
            example: customer_3faa484998f44cfead9668608b9ee1f5
            type: string
        - name: status
          required: false
          in: query
          description: Filter quotes by status.
          schema:
            example: active
            enum:
              - active
              - used
              - expired
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListQuotesResponseDto'
              example:
                page: 1
                limit: 10
                total: 1
                data:
                  - id: quote_d243ab2b1de4447d8a046d87fefe58cf
                    status: active
                    type: off_ramp
                    customerId: customer_3faa484998f44cfead9668608b9ee1f5
                    fees:
                      integratorFee:
                        fixedAmount: '0.00'
                        bpsRate: '20'
                        bpsAmount: '0.20'
                        totalAmount: '0.20'
                        currency: usdc
                      platformFee:
                        fixedAmount: '0.00'
                        bpsRate: '20'
                        bpsAmount: '0.20'
                        totalAmount: '0.20'
                        currency: usdc
                    source:
                      currency: usdc
                      network: polygon
                      amount: '100.00'
                    destination:
                      currency: brl
                      network: pix
                      amount: '545.50'
                      exchangeRate: '5.455'
                    expiresAt: '2025-01-01T00:01:00.000Z'
                    created: '2025-01-01T00:00:00.000Z'
                    updated: '2025-01-01T00:00:00.000Z'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
              examples:
                Bad Request:
                  summary: Bad Request
                  value:
                    status: 400
                    detail: Invalid request parameters
                    code: address/invalid
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
              examples:
                Not Found:
                  summary: Not Found
                  value:
                    status: 404
                    detail: Resource not found
                    code: resource/not-found
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
        '422':
          description: Unprocessable Entity - Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
              examples:
                Validation Error:
                  summary: Validation Error
                  value:
                    status: 422
                    detail: Validation failed
                    code: validation/failed
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
                    errors:
                      - detail: Invalid email format
                        pointer: /email
                      - detail: Name is required
                        pointer: /name
components:
  schemas:
    ListQuotesResponseDto:
      type: object
      properties:
        page:
          description: Current page number
          example: 1
          type: number
        limit:
          description: Number of items per page
          example: 10
          type: number
          minimum: 1
          exclusiveMinimum: false
          maximum: 100
          exclusiveMaximum: false
        total:
          description: Total number of items
          example: 1
          type: number
        totalPages:
          description: Total number of pages
          example: 1
          type: number
        hasNext:
          description: Whether there is a next page
          example: false
          type: boolean
        hasPrevious:
          description: Whether there is a previous page
          example: false
          type: boolean
        data:
          description: The list of quotes for the current page.
          type: array
          items:
            type: object
            properties:
              id:
                description: A unique identifier for the quote.
                example: quote_d243ab2b1de4447d8a046d87fefe58cf
                pattern: ^quote_[a-z0-9]+$
                type: string
              status:
                description: The current status of the quote.
                example: active
                enum:
                  - active
                  - used
                  - expired
                type: string
              type:
                description: The transfer type this quote is for.
                example: off_ramp
                type: string
                enum:
                  - on_ramp
                  - off_ramp
              customerId:
                description: The customer ID.
                example: customer_d243ab2b1de4447d8a046d87fefe58cf
                type: string
              fees:
                type: object
                properties:
                  integratorFee:
                    description: The integrator fee portion.
                    example:
                      fixedAmount: '0.00'
                      bpsRate: '0'
                      totalAmount: '0.00'
                      currency: usdc
                    type: object
                    properties:
                      fixedAmount:
                        description: The fixed amount of the fee.
                        example: '1.00'
                        type: string
                      bpsRate:
                        description: The BPS rate of the fee.
                        example: '10'
                        type: string
                      bpsAmount:
                        description: >-
                          The dollar amount of the BPS-based fee component
                          (sourceAmount × bpsRate / 10000).
                        example: '0.10'
                        type: string
                      totalAmount:
                        description: >-
                          The total amount of the fee applied to the source
                          amount.
                        example: '1.10'
                        type: string
                      currency:
                        description: The currency of the fee.
                        example: brl
                        oneOf:
                          - type: string
                            enum:
                              - usdc
                              - usdt
                              - eurc
                          - type: string
                            enum:
                              - usd
                              - eur
                              - brl
                    required:
                      - fixedAmount
                      - bpsRate
                      - bpsAmount
                      - totalAmount
                      - currency
                  platformFee:
                    description: The platform fee portion.
                    example:
                      fixedAmount: '0.00'
                      bpsRate: '20'
                      totalAmount: '2.00'
                      currency: usdc
                    type: object
                    properties:
                      fixedAmount:
                        description: The fixed amount of the fee.
                        example: '1.00'
                        type: string
                      bpsRate:
                        description: The BPS rate of the fee.
                        example: '10'
                        type: string
                      bpsAmount:
                        description: >-
                          The dollar amount of the BPS-based fee component
                          (sourceAmount × bpsRate / 10000).
                        example: '0.10'
                        type: string
                      totalAmount:
                        description: >-
                          The total amount of the fee applied to the source
                          amount.
                        example: '1.10'
                        type: string
                      currency:
                        description: The currency of the fee.
                        example: brl
                        oneOf:
                          - type: string
                            enum:
                              - usdc
                              - usdt
                              - eurc
                          - type: string
                            enum:
                              - usd
                              - eur
                              - brl
                    required:
                      - fixedAmount
                      - bpsRate
                      - bpsAmount
                      - totalAmount
                      - currency
                required:
                  - integratorFee
                  - platformFee
              source:
                type: object
                properties:
                  currency:
                    description: The source currency.
                    example: usdc
                    oneOf:
                      - type: string
                        enum:
                          - usdc
                          - usdt
                          - eurc
                      - type: string
                        enum:
                          - usd
                          - eur
                          - brl
                  network:
                    description: The source network.
                    example: polygon
                    oneOf:
                      - type: string
                        enum:
                          - sol
                          - fogo
                          - ethereum
                          - optimism
                          - arbitrum
                          - polygon
                          - base
                          - avalanche
                          - sui
                          - noble
                          - sei
                          - tron
                          - starknet
                          - aptos
                          - hyperliquid
                      - type: string
                        enum:
                          - wire
                          - ach
                          - achPush
                          - achPull
                          - swift
                          - sepa
                          - pix
                  amount:
                    description: The source amount.
                    example: '100.00'
                    type: string
                required:
                  - currency
                  - network
                  - amount
              destination:
                type: object
                properties:
                  currency:
                    description: The destination currency.
                    example: brl
                    oneOf:
                      - type: string
                        enum:
                          - usdc
                          - usdt
                          - eurc
                      - type: string
                        enum:
                          - usd
                          - eur
                          - brl
                  network:
                    description: The destination network.
                    example: pix
                    oneOf:
                      - type: string
                        enum:
                          - sol
                          - fogo
                          - ethereum
                          - optimism
                          - arbitrum
                          - polygon
                          - base
                          - avalanche
                          - sui
                          - noble
                          - sei
                          - tron
                          - starknet
                          - aptos
                          - hyperliquid
                      - type: string
                        enum:
                          - wire
                          - ach
                          - achPush
                          - achPull
                          - swift
                          - sepa
                          - pix
                  amount:
                    description: The destination amount after exchange.
                    example: '545.50'
                    type: string
                  exchangeRate:
                    description: >-
                      The exchange rate applied to convert source to
                      destination.
                    example: '5.455'
                    type: string
                required:
                  - currency
                  - network
                  - amount
                  - exchangeRate
              expiresAt:
                description: The datetime when this quote expires.
                example: '2025-01-01T00:01:00.000Z'
                type: string
                format: date-time
              created:
                description: The datetime the quote was created.
                example: '2025-01-01T00:00:00.000Z'
                type: string
                format: date-time
              updated:
                description: The datetime the quote was last updated.
                example: '2025-01-01T00:00:30.000Z'
                type: string
                format: date-time
            required:
              - id
              - status
              - type
              - customerId
              - fees
              - source
              - destination
              - expiresAt
              - created
              - updated
      required:
        - page
        - limit
        - total
        - totalPages
        - hasNext
        - hasPrevious
        - data
    ProblemDetailsDto:
      type: object
      properties:
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        code:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              detail:
                type: string
              pointer:
                type: string
              parameter:
                type: string
              header:
                type: string
            required:
              - detail
        correlationId:
          type: string
      required:
        - status
        - detail
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````