List quotes

GET https://app.speybooks.com/api/v1/quotes/

Returns a paginated list of quotes with optional status filtering. Includes aggregate stats: draft count, sent count, accepted count, and expired count (sent quotes past their validUntil date).

Query parameters

page integer optional Default: 1

Page number. Default 1.

perPage integer optional Default: 50

Results per page. Default 50.

status string optional

Filter by quote status (draft, sent, accepted, declined, converted).

Response

200 Paginated list of quotes with status counts (draft, sent, accepted, expired).

Show response fields

quotes array<object>

Show child attributes

id string

quoteNumber string

status string

total integer

stats object

Show child attributes

acceptedCount integer

draftCount integer

expiredCount integer

sentCount integer

Request GET /v1/quotes/ curl

curl "https://api.speybooks.com/v1/quotes?status=sent&page=1&perPage=20" \
  -H "Authorization: Bearer sk_test_..."

Response 200

{
  "success": true,
  "data": {
    "quotes": [
      {
        "id": "quo_42",
        "quoteNumber": "QT-2026-0001",
        "status": "sent",
        "total": 180000
      }
    ],
    "stats": {
      "draftCount": 2,
      "sentCount": 5,
      "acceptedCount": 3,
      "expiredCount": 1
    }
  },
  "meta": {
    "page": 1,
    "perPage": 20,
    "total": 5,
    "pages": 1
  }
}