Skip to main content
List Quotes
curl --request GET \
  --url https://api.spherepay.co/v2/quote \
  --header 'Authorization: Bearer <token>'
{
  "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"
    }
  ]
}
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.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page
string
default:1
required

Page number of the list (default: 1)

Example:

1

​
limit
string
default:10
required

Number of items per page (default: 10)

Example:

10

​
customerId
string

Filter quotes by customer ID.

Pattern: ^customer_[a-z0-9]+$
Example:

"customer_3faa484998f44cfead9668608b9ee1f5"

​
status
enum<string>

Filter quotes by status.

Available options:
active,
used,
expired
Example:

"active"

Response

​
page
number
required

Current page number

Example:

1

​
limit
number
required

Number of items per page

Required range: 1 < x < 100
Example:

10

​
total
number
required

Total number of items

Example:

1

​
totalPages
number
required

Total number of pages

Example:

1

​
hasNext
boolean
required

Whether there is a next page

Example:

false

​
hasPrevious
boolean
required

Whether there is a previous page

Example:

false

​
data
object[]
required

The list of quotes for the current page.

Last modified on June 18, 2026