Price a physical-mail letter without creating it

POST https://api.dairo.app/v1/letters/price

Returns the exact price of a letter without creating one — no side effects, nothing stored. Provide country plus either pageCount (minimum 1) or pdfBase64, in which case Dairo counts the pages of the actual file; print and delivery default to the same values as the create call (grayscale, simplex, economy). The response is a letter_price whose upper-case currency and amount (VAT included) are what the letter is billed when mailed. The quote runs the same destination and option validation as POST /v1/letters, so a successful quote also confirms the combination is sendable. Requires only the letters:read scope, so a read-only key can quote prices.

Scope: letters:read. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

curl -X POST "https://api.dairo.app/v1/letters/price" \
  -H "Authorization: Bearer $DAIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Body

Required, application/json: LetterPriceRequest.

Give the destination (country or to.country) and one page source: pageCount, pdfBase64, file, or templateId (rendered with templateData and to to count pages). First match wins in that order.

Response

200 Success. Body: application/json, LetterPrice.

{
  "object": "letter_price",
  "currency": "EUR",
  "amount": 0,
  "walletAmount": 0,
  "walletCurrency": "string",
  "walletRate": 0,
  "country": "DE",
  "pageCount": 0,
  "delivery": "economy",
  "print": {
    "mode": "color",
    "sides": "simplex",
    "addressPlacement": "left"
  },
  "breakdown": {
    "providerCost": {
      "currency": "EUR",
      "amount": 0,
      "walletAmount": 0,
      "walletCurrency": "string",
      "walletRate": 0
    },
    "marginPct": 0
  }
}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.