Skip to Content
Prets Developer Portal

List quotes

GET
/v1/quotes

to try read requests with your account, or paste an API key into the Authorization field. Create an API key in the Partner Portal.

Lists the quotes in your organization, newest first. Pass links.next.cursor back as cursor to fetch the next page, and add expand=lineItems or expand=progressSummary to include those fields on each quote.

Returns a page of quotes in data, with hasMore and links.next. data is an empty array when there are no quotes, and links.next is null on the last page.

Query Parameters

cursor?string

Opaque list cursor from a previous links.next.cursor

limit?integer

Page-size hint for the first page (1–250). Frozen into the Cursor for the rest of the scroll; ignored when cursor is present.

Range0 < value <= 250
expand?|array<string>

Repeated field names to expand. Allowlisted: lineItems, progressSummary. Unknown names are invalid.

Response Body

A page of quotes, newest first

application/json
  1. response

Paginated list of quotes. Default items are ListQuote; expand=lineItems yields Quote; expand=progressSummary includes progressSummary.

data*array<|>
hasMore*boolean

True when another page exists; always equals links.next != null

links*

List pagination links. next is null on the last page

Authorization

bearerAuth
headerAuthorizationBearer <token>
Example Request
curl -X GET 'https://api.prets.app/v1/quotes'
Example Response
{  "data": [    {      "quoteId": "qot_01ARZ3NDEKTSV4RRFFQ69G5FAV",      "opportunity": {        "opportunityId": "opp_01ARZ3NDEKTSV4RRFFQ69G5FAV"      },      "merchant": {        "name": "Test merchant",        "merchantId": "mer_01ARZ3NDEKTSV4RRFFQ69G5FAV",        "slug": "test-merchant"      },      "progressSummary": "The financing application is under review at the lender. Prets will follow up when an offer is available.",      "createdAt": "2024-06-15T10:30:00.000Z",      "updatedAt": "2024-06-15T10:30:00.000Z",      "address": {        "country": "NL",        "postalCode": "1000 AA",        "city": "Amsterdam",        "street": "Kerkstraat",        "houseNumber": "42",        "houseNumberAddition": "A",        "municipality": "Amsterdam"      },      "contact": {        "email": "jan.jansen@example.nl",        "firstName": "Jan",        "lastName": "Jansen",        "phoneNumber": "+31612345678"      },      "currency": "EUR",      "terms": [        "subject_to_financing"      ],      "expiresAt": "2024-12-31",      "sentAt": "2024-06-15",      "totalInclTax": 25000,      "totalExclTax": 20661.16,      "description": "Quote for residential solar panel installation.",      "intakeNote": "Partner must co-sign; installer visit booked for 12 March.",      "installer": {        "name": "Warmte Comfort B.V."      },      "externalId": "QUOTE-2024-001",      "tags": [        "smartphone_only",        "less_digitally_skilled"      ],      "financing": {        "phase": "new",        "status": "under_review",        "subStatus": {          "type": "none"        },        "method": [          "loan",          "subsidy"        ],        "waitingOn": "merchant",        "statusChangedAt": "2024-06-15T10:30:00.000Z"      },      "lineItems": [        {          "type": "battery",          "externalId": "QUOTE-2024-001-PV",          "totalInclTax": 12500,          "totalExclTax": 10330.58,          "unitPrice": 250,          "productIdentifiers": {            "brand": "Enphase",            "manufacturerPartNumber": "SE7600H-US",            "globalTradeItemNumber": "0885629362058"          },          "incentiveCodes": [            "ISDE-2024-WP",            "PROV-NH-2024"          ],          "description": "Including installation and commissioning",          "totalNameplateCapacity": 13500,          "totalNameplatePower": 5000,          "lineItemId": "lit_01ARZ3NDEKTSV4RRFFQ69G5FAV"        }      ]    }  ],  "hasMore": true,  "links": {    "next": {      "href": "string",      "cursor": "string"    }  }}