Offers

Create an offer

post/offers

Request

Base URL: https://api.lumabill.ch/v1
URL: https://api.lumabill.ch/v1/offers
Auth: HTTP bearer

Request body

client_idstring uuid required

offer_numberstring nullable

status'draft' | 'sent'

valid_untilstring date nullable

currency'CHF' | 'EUR' | 'USD' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'SEK' | 'NOK' | 'DKK' | 'HUF' required

ISO 4217 code of a currency the API converts (ESTV/BAZG rates). The same list applies to every currency field of the API.

Example request

{
  "offer_number": "OFR-2025-0007",
  "currency": "CHF",
  "lines": [
    {
      "description": "Web development - May 2025",
      "quantity": 8,
      "price": 150,
      "vat_rate": 8.1
    }
  ]
}

Response

Offer created

idstring uuid required

client_idstring uuid required

offer_numberstring nullable required

null while the offer is an unnumbered draft (numbered when first sent/accepted/declined).

status'draft' | 'sent' | 'accepted' | 'rejected' required

valid_untilstring date nullable

totalnumber double required

currency'CHF' | 'EUR' | 'USD' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'SEK' | 'NOK' | 'DKK' | 'HUF' required

ISO 4217 code of a currency the API converts (ESTV/BAZG rates). The same list applies to every currency field of the API.

created_atstring date-time required

Example response

{
  "id": "f6a7b8c9-6789-abcd-f012-345678901234",
  "client_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "offer_number": "OFR-2025-0007",
  "status": "sent",
  "valid_until": "2025-06-15",
  "total": 4500,
  "currency": "CHF",
  "lines": [
    {
      "description": "Web development - May 2025",
      "quantity": 8,
      "price": 150,
      "vat_rate": 8.1
    }
  ],
  "created_at": "2025-05-01T10:00:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.