List quotes

GEThttps://app.speybooks.com/api/v1/quotes/

Returns a paginated list of quotes with optional status filtering (draft, sent, accepted, declined, converted, or expired, where expired selects sent quotes past their validUntil date). Includes aggregate stats: draftCount, sentCount, acceptedCount, and expiredCount.

Query parameters

pageintegeroptionalDefault: 1

Page number. Default 1.

perPageintegeroptionalDefault: 50

Results per page. Default 50.

statusstringoptional

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

Response

200Paginated list of quotes with status counts.

Show response fields

quotesarray<object>

Show child attributes

contactIdstring

contactNamestring

createdAtstringdate-time

idstring

issueDatestring

quoteNumberstring

statusstring

subtotalinteger

totalinteger

validUntilstring

vatAmountinteger

statsobject

Show child attributes

acceptedCountinteger

draftCountinteger

expiredCountinteger

sentCountinteger

RequestGET/v1/quotes/curl

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

Response200

{
  "success": true,
  "data": {
    "quotes": [
      {
        "id": "quo_42",
        "quoteNumber": "QT-0007",
        "contactId": "cont_3",
        "contactName": "Acme Ltd",
        "issueDate": "2026-06-01",
        "validUntil": "2026-07-01",
        "subtotal": 20000,
        "vatAmount": 4000,
        "total": 24000,
        "status": "sent",
        "createdAt": "2026-06-01T10:15:00.000Z"
      }
    ],
    "stats": {
      "draftCount": 2,
      "sentCount": 5,
      "acceptedCount": 3,
      "expiredCount": 1
    }
  },
  "meta": {
    "page": 1,
    "perPage": 20,
    "total": 5,
    "pages": 1
  }
}