Skip to main content
POST
/
v1
/
quotes
Create a quote
curl --request POST \
  --url https://api.prets.io/v1/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": {
    "postalCode": "1000",
    "country": "NL",
    "houseNumber": "42",
    "streetAddress": "Rue de la Loi 200",
    "streetAddress2": "Apt 4B",
    "city": "Brussels",
    "street": "Kerkstraat",
    "houseNumberAddition": "A"
  },
  "contact": {
    "email": "jan.jansen@example.nl",
    "firstName": "Jan",
    "lastName": "Jansen",
    "phoneNumber": "+31612345678"
  },
  "currency": "EUR",
  "totalInclTax": 25000,
  "lineItems": [
    {
      "type": "battery",
      "totalInclTax": 12500,
      "totalNameplateCapacity": 13500,
      "totalNameplatePower": 5000,
      "externalId": "QUOTE-2024-001-PV",
      "totalExclTax": 10330.58,
      "unitPrice": 250,
      "productIdentifiers": {
        "brand": "Enphase",
        "manufacturerPartNumber": "SE7600H-US",
        "globalTradeItemNumber": "0885629362058"
      },
      "incentiveCodes": [
        "ISDE-2024-WP",
        "PROV-NH-2024"
      ],
      "description": "<string>"
    }
  ],
  "terms": [
    "subject_to_financing"
  ],
  "expiresAt": "2024-12-31T23:59:59Z",
  "sentAt": "2024-06-15T10:30:00Z",
  "totalExclTax": 20661.16,
  "description": "<string>"
}
'
{
  "data": {
    "quoteId": "123e4567-e89b-12d3-a456-426614174000"
  },
  "links": {
    "session": "https://app.prets.nl/session?ticket=abc123"
  }
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
sessionUrl
boolean | null
default:false

Include a single-use session URL in the response

Example:

true

Body

application/json

Create a new quote for sustainability home improvements

​
address
Dutch Address · object
required

Installation address (Dutch or international format based on country)

​
contact
object
required

Customer contact information

​
currency
enum<string>
required

Quote currency (currently EUR only)

Available options:
EUR
Example:

"EUR"

​
totalInclTax
number
required

Total quote amount including tax in EUR

Required range: x >= 0
Example:

25000

​
lineItems
(Battery · object | PV Solar Panels · object | Heat Pump · object | Wall Insulation · object | Sloped Roof Insulation · object | Flat Roof Insulation · object | Floor Insulation · object | Windows · object)[]
required

Line items for the quote (at least one required)

Minimum array length: 1

Battery storage system line item

​
terms
enum<string>[]

Quote terms and conditions

Available options:
subject_to_financing
Example:
["subject_to_financing"]
​
expiresAt
string<date>

Quote expiration timestamp (ISO 8601)

Example:

"2024-12-31T23:59:59Z"

​
sentAt
string<date>

Timestamp when quote was sent to customer (ISO 8601)

Example:

"2024-06-15T10:30:00Z"

​
totalExclTax
number

Total quote amount excluding tax in EUR

Required range: x >= 0
Example:

20661.16

​
description
string

Description of the quote

Response

Quote created successfully

Quote creation response

​
data
object
required
​
links
object

Hypermedia navigation links