Skip to Content
Prets Developer Portal

API Changelog

Changes to the public Prets API, updated weekly.

November 9–15, 2026QuotesBreaking

Installer name on quotes, and a session link for indicative quotes.

🧾 Quotes

  • POST /v1/quotes, GET /v1/quotes, and GET /v1/quotes/{quoteId}: the expected installer is optional installer.name. A request that still sends expectedInstaller does not store it. (Breaking)
  • POST /v1/quotes with session=true on an indicative quote returns links.session. That link opens the orientation page. It no longer responds 422. (Breaking)
  • POST /v1/quotes treats a blank contact.firstName as omitted. (Additive)
October 19–25, 2026QuotesBreaking

Indicative quotes use a term instead of isIndicative.

🧾 Quotes

  • POST /v1/quotes no longer accepts isIndicative. Send "terms": ["indicative"] for an indicative quote. (Breaking)
  • Quote responses include indicative in terms while the quote is indicative; isIndicative is gone. (Breaking)
  • A client still sending isIndicative: true now gets a presented quote. (Breaking)
  • Indicative creates still omit opportunity, set financing.status to orientation, and reject session=true with 422.

Details: Create a quote, Indicative quotes.

CreateQuote supports unsigned quotes and indicative labelling.

🧾 Quotes

  • POST /v1/quotes accepts optional isIndicative. Omit it (or set false) for the default create: Presented with Opportunity, unchanged from before. Set isIndicative: true only for an indicative quote (Indicative, no Opportunity). (Additive)
  • Response isIndicative is derived from Status__c (Indicative vs other values). (Additive)
  • Unsigned indicative quotes omit opportunity but always include financing with status: orientation. Presented quotes keep the existing journey. (Additive)
  • session=true returns 422 for unsigned creates because session links require an Opportunity. (Additive)

Details: Create a quote, Indicative quotes.

CreateQuote accepts more measure types and documents 422 errors.

🧾 Quotes

  • POST /v1/quotes accepts named measure types (wall insulation, heat battery, boilers, ventilation, and more) plus ev_charger, installation, and other. (Additive)
  • other and installation lines accept optional belongsTo. ev_charger accepts optional nameplatePower, phases, and outlet. (Additive)
  • CreateQuote documents the 422 validation envelope and intake-field errors. (Additive)

Cases API and case lifecycle events.

🎫 Cases

  • Documented six Cases routes: GET /v1/cases, POST /v1/quotes/{quoteId}/cases, GET /v1/cases/{caseId}, GET/POST /v1/cases/{caseId}/messages, and POST /v1/cases/{caseId}/close. (Additive)
  • GET /v1/cases filters: state (open/closed), quoteId, updatedSince, plus cursor/limit. Messages are a sub-resource, not embedded on Case. (Additive)

🔔 Events

  • New webhooks: case.created, case.updated, case.closed, case.message.replied. Thin payloads; refetch GET /v1/cases/{caseId} (and /messages for replies). (Additive)

Public quote list defaults to ListQuote; expand line items when you need them.

🧾 Quotes

  • GET /v1/quotes is now documented. Default items are ListQuote (Quote without lineItems). Pass expand=lineItems for Quote. GetQuote is unchanged. (Additive)
  • Unknown expand values return 400 parameter_invalid with param=expand. (Additive)

Optional municipality on Dutch quote addresses.

🧾 Quotes

  • POST /v1/quotes and GET /v1/quotes/{quoteId}: Dutch address objects accept optional municipality (gemeente), distinct from city. (Additive)

Optional intake note on create and get quote.

🧾 Quotes

  • POST /v1/quotes and GET /v1/quotes/{quoteId}: added optional intakeNote — merchant context for Prets at quote handover. (Additive)

Subsidy line items, quote portal deeplinks, and more forgiving postal code validation.

🧾 Quotes

  • POST /v1/quotes and GET /v1/quotes/{quoteId}: added a new subsidy line item type. It carries a negative totalInclTax (a reduction applied to the quote total) and a required incentiveCodes array, whose codes must match incentive codes declared on other QuoteLineItems. (Additive)
  • POST /v1/quotes and GET /v1/quotes/{quoteId}: added links.portalQuote, a deeplink to the quote in the merchant portal. Present only for organization API keys. (Additive)
  • POST /v1/quotes: Dutch postal codes with a lowercase letter suffix (for example 8101xp) are now accepted and normalized to the 1234 AB format. Requests that previously failed validation now succeed. (Additive)
June 22–28, 2026QuotesEventsBreaking

A richer quote financing contract, a renamed financing webhook event, and a standardized error format.

🧾 Quotes

  • GET /v1/quotes/{quoteId} and POST /v1/quotes: the financing object is now always present and richer. Added phase, method (array of loan / own_funds / subsidy), and waitingOn. (Breaking)
  • financing.subStatus is now required and uses a type discriminator with none, on_hold, and canceled arms (the previous extra_info_needed arm was removed). (Breaking)
  • financing.status values changed: financing_completed → completed, and cancelled_by_customer was split into canceled_by_consumer and offer_canceled. Added additional_documents_required and invoice_pending. (Breaking)
  • New on_hold reasons: installation_blocked, general_question, and unknown. (Additive)

🔔 Events

  • The quote.financing.cancelled webhook event was renamed to quote.financing.canceled. (Breaking)

⚠️ Errors

  • All endpoints now return a standardized error envelope: { error: { type, code, message, param?, requestId } }. The message field is unchanged; type, code, param, and requestId are new. (Additive)
June 15–21, 2026QuotesBreaking

Stricter validation for quote incentive codes and terms.

🧾 Quotes

  • POST /v1/quotes: lineItems[].incentiveCodes and terms no longer accept values containing a semicolon (;). Requests that include a semicolon in these fields now fail validation. (Breaking)