Create estimate

POST

estimates

Create estimate

curl --request POST \
  --url https://api.infinity.swiss/v1/estimates \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '
{
  "openingDate": "2023-12-25",
  "positions": [
    {
      "type": "product",
      "name": "<string>",
      "singleAmount": 12000,
      "quantity": 2,
      "contraAccount": 5499,
      "unit": "<string>",
      "taxCode": "",
      "articleNumber": "<string>",
      "description": "<string>",
      "date": "<string>",
      "discountRate": 50,
      "customTextColumns": {
        "customTextColumn1": "<string>",
        "customTextColumn2": "<string>",
        "customTextColumn3": "<string>"
      }
    }
  ],
  "isDraft": true,
  "template": "<string>",
  "recipient": "<string>",
  "customRecipientText": "<string>",
  "externalReference": "<string>",
  "title": "<string>",
  "payableInDays": 182,
  "introductoryText": "<string>",
  "closingText": "<string>",
  "columns": [],
  "originalCurrency": "<string>",
  "exchangeRate": 123
}
'

import requests

url = "https://api.infinity.swiss/v1/estimates"

payload = {
    "openingDate": "2023-12-25",
    "positions": [
        {
            "type": "product",
            "name": "<string>",
            "singleAmount": 12000,
            "quantity": 2,
            "contraAccount": 5499,
            "unit": "<string>",
            "taxCode": "",
            "articleNumber": "<string>",
            "description": "<string>",
            "date": "<string>",
            "discountRate": 50,
            "customTextColumns": {
                "customTextColumn1": "<string>",
                "customTextColumn2": "<string>",
                "customTextColumn3": "<string>"
            }
        }
    ],
    "isDraft": True,
    "template": "<string>",
    "recipient": "<string>",
    "customRecipientText": "<string>",
    "externalReference": "<string>",
    "title": "<string>",
    "payableInDays": 182,
    "introductoryText": "<string>",
    "closingText": "<string>",
    "columns": [],
    "originalCurrency": "<string>",
    "exchangeRate": 123
}
headers = {
    "x-api-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    openingDate: '2023-12-25',
    positions: [
      {
        type: 'product',
        name: '<string>',
        singleAmount: 12000,
        quantity: 2,
        contraAccount: 5499,
        unit: '<string>',
        taxCode: '',
        articleNumber: '<string>',
        description: '<string>',
        date: '<string>',
        discountRate: 50,
        customTextColumns: {
          customTextColumn1: '<string>',
          customTextColumn2: '<string>',
          customTextColumn3: '<string>'
        }
      }
    ],
    isDraft: true,
    template: '<string>',
    recipient: '<string>',
    customRecipientText: '<string>',
    externalReference: '<string>',
    title: '<string>',
    payableInDays: 182,
    introductoryText: '<string>',
    closingText: '<string>',
    columns: [],
    originalCurrency: '<string>',
    exchangeRate: 123
  })
};

fetch('https://api.infinity.swiss/v1/estimates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.infinity.swiss/v1/estimates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'openingDate' => '2023-12-25',
    'positions' => [
        [
                'type' => 'product',
                'name' => '<string>',
                'singleAmount' => 12000,
                'quantity' => 2,
                'contraAccount' => 5499,
                'unit' => '<string>',
                'taxCode' => '',
                'articleNumber' => '<string>',
                'description' => '<string>',
                'date' => '<string>',
                'discountRate' => 50,
                'customTextColumns' => [
                                'customTextColumn1' => '<string>',
                                'customTextColumn2' => '<string>',
                                'customTextColumn3' => '<string>'
                ]
        ]
    ],
    'isDraft' => true,
    'template' => '<string>',
    'recipient' => '<string>',
    'customRecipientText' => '<string>',
    'externalReference' => '<string>',
    'title' => '<string>',
    'payableInDays' => 182,
    'introductoryText' => '<string>',
    'closingText' => '<string>',
    'columns' => [
        
    ],
    'originalCurrency' => '<string>',
    'exchangeRate' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infinity.swiss/v1/estimates"

	payload := strings.NewReader("{\n  \"openingDate\": \"2023-12-25\",\n  \"positions\": [\n    {\n      \"type\": \"product\",\n      \"name\": \"<string>\",\n      \"singleAmount\": 12000,\n      \"quantity\": 2,\n      \"contraAccount\": 5499,\n      \"unit\": \"<string>\",\n      \"taxCode\": \"\",\n      \"articleNumber\": \"<string>\",\n      \"description\": \"<string>\",\n      \"date\": \"<string>\",\n      \"discountRate\": 50,\n      \"customTextColumns\": {\n        \"customTextColumn1\": \"<string>\",\n        \"customTextColumn2\": \"<string>\",\n        \"customTextColumn3\": \"<string>\"\n      }\n    }\n  ],\n  \"isDraft\": true,\n  \"template\": \"<string>\",\n  \"recipient\": \"<string>\",\n  \"customRecipientText\": \"<string>\",\n  \"externalReference\": \"<string>\",\n  \"title\": \"<string>\",\n  \"payableInDays\": 182,\n  \"introductoryText\": \"<string>\",\n  \"closingText\": \"<string>\",\n  \"columns\": [],\n  \"originalCurrency\": \"<string>\",\n  \"exchangeRate\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.infinity.swiss/v1/estimates")
  .header("x-api-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"openingDate\": \"2023-12-25\",\n  \"positions\": [\n    {\n      \"type\": \"product\",\n      \"name\": \"<string>\",\n      \"singleAmount\": 12000,\n      \"quantity\": 2,\n      \"contraAccount\": 5499,\n      \"unit\": \"<string>\",\n      \"taxCode\": \"\",\n      \"articleNumber\": \"<string>\",\n      \"description\": \"<string>\",\n      \"date\": \"<string>\",\n      \"discountRate\": 50,\n      \"customTextColumns\": {\n        \"customTextColumn1\": \"<string>\",\n        \"customTextColumn2\": \"<string>\",\n        \"customTextColumn3\": \"<string>\"\n      }\n    }\n  ],\n  \"isDraft\": true,\n  \"template\": \"<string>\",\n  \"recipient\": \"<string>\",\n  \"customRecipientText\": \"<string>\",\n  \"externalReference\": \"<string>\",\n  \"title\": \"<string>\",\n  \"payableInDays\": 182,\n  \"introductoryText\": \"<string>\",\n  \"closingText\": \"<string>\",\n  \"columns\": [],\n  \"originalCurrency\": \"<string>\",\n  \"exchangeRate\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.infinity.swiss/v1/estimates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"openingDate\": \"2023-12-25\",\n  \"positions\": [\n    {\n      \"type\": \"product\",\n      \"name\": \"<string>\",\n      \"singleAmount\": 12000,\n      \"quantity\": 2,\n      \"contraAccount\": 5499,\n      \"unit\": \"<string>\",\n      \"taxCode\": \"\",\n      \"articleNumber\": \"<string>\",\n      \"description\": \"<string>\",\n      \"date\": \"<string>\",\n      \"discountRate\": 50,\n      \"customTextColumns\": {\n        \"customTextColumn1\": \"<string>\",\n        \"customTextColumn2\": \"<string>\",\n        \"customTextColumn3\": \"<string>\"\n      }\n    }\n  ],\n  \"isDraft\": true,\n  \"template\": \"<string>\",\n  \"recipient\": \"<string>\",\n  \"customRecipientText\": \"<string>\",\n  \"externalReference\": \"<string>\",\n  \"title\": \"<string>\",\n  \"payableInDays\": 182,\n  \"introductoryText\": \"<string>\",\n  \"closingText\": \"<string>\",\n  \"columns\": [],\n  \"originalCurrency\": \"<string>\",\n  \"exchangeRate\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "estimate": {
    "id": "<string>",
    "isDraft": true,
    "number": "<string>",
    "organisation": "<string>",
    "template": "<string>",
    "openingDate": "2023-12-25",
    "dueDate": "2023-12-25",
    "positions": [
      {
        "type": "product",
        "name": "<string>",
        "singleAmount": 12000,
        "quantity": 2,
        "contraAccount": 5499,
        "id": "<string>",
        "unit": "<string>",
        "taxCode": "",
        "articleNumber": "<string>",
        "description": "<string>",
        "date": "<string>",
        "discountRate": 50,
        "customTextColumns": {
          "customTextColumn1": "<string>",
          "customTextColumn2": "<string>",
          "customTextColumn3": "<string>"
        },
        "totalAmount": 123,
        "vatDebt": 123,
        "originalCurrency": "<string>",
        "exchangeRate": 123
      }
    ],
    "totalAmount": 123,
    "totalNetAmount": 123,
    "totalVatDebt": 123,
    "status": "open",
    "recipient": "<string>",
    "customRecipientText": "<string>",
    "externalReference": "<string>",
    "title": "<string>",
    "payableInDays": 123,
    "introductoryText": "<string>",
    "closingText": "<string>",
    "amountMode": "gross",
    "language": "de",
    "originalCurrency": "<string>",
    "exchangeRate": 123,
    "columns": [
      "quantity"
    ],
    "emailDeliveries": [
      {
        "recipientEmail": "jsmith@example.com",
        "status": "<string>",
        "timestamp": "2023-11-07T05:31:56Z"
      }
    ],
    "publicPdfUrl": "<string>",
    "signingPerson": "<string>",
    "signedAt": "2023-11-07T05:31:56Z",
    "invoicesFromQuote": [
      "<string>"
    ]
  }
}

{
  "code": "<string>",
  "invalidFields": [
    "<string>"
  ]
}

{
  "code": "general/unauthorised"
}

{
  "code": "<string>"
}

{
  "code": "<string>"
}

Creating an estimate

Estimates (quotes) share their structure with invoices, but never post accounting transactions. The lifecycle status of an estimate (open, accepted, rejected) is managed through the Set estimate status endpoint. To turn an accepted estimate into an invoice, use Convert estimate to invoice. The position structure is identical to invoices — see Create invoice for the full reference, including external references. Estimates may also be issued in a foreign currency by providing originalCurrency (and optionally exchangeRate; when omitted, the organisation’s stored rate is used). When converted to an invoice the FX details and external references are carried over.

Example

{
  "template": "6474bb0cccc5b63aae56fa15",
  "openingDate": "2026-05-12",
  "recipient": "6474bb0cccc5b63aae56fa20",
  "title": "Offerte Beratungsmandat Q3",
  "isDraft": false,
  "payableInDays": 30,
  "amountMode": "gross",
  "language": "de",
  "positions": [
    {
      "type": "product",
      "name": "Beratungsmandat",
      "quantity": 40,
      "unit": "h",
      "singleAmount": 18000,
      "contraAccount": 3200,
      "taxCode": "UN81"
    }
  ]
}

Retrying safely with idempotency keys

If a request fails or times out, provide a unique Idempotency-Key header (for example a UUID) to retry it without creating a duplicate estimate:

Idempotency-Key: 4cbe4d8c-8952-46a5-8bcd-1b4a67d0c496

A retry with the same key and payload returns the response of the original request instead of creating the estimate again. Keys are scoped to your organisation, API key and endpoint, and are retained for 24 hours. See Create invoice for the full behaviour, including the 409 Conflict errors returned when a key is reused with a different payload or while a request is still being processed.

Authorizations

x-api-token

string

header

required

API token for authentication. Obtain from your Infinity account settings.

Headers

Idempotency-Key

string

A unique key that makes this request idempotent, for example a UUID. If a request fails or times out, it can safely be retried with the same key without creating a duplicate: a retry with the same key and payload returns the status and response of the original request, including the resource it created.

Keys are scoped to your organisation and API key, and are retained for 24 hours. Reusing a key with a different payload returns 409 Conflict. While a request is still being processed, other requests with the same key also return 409 Conflict.

Required string length: 1 - 200

Body

application/json

The estimate payload.

Request body for creating an estimate.

openingDate

string<date>

required

The opening date (issue date) of the document in YYYY-MM-DD format. For invoices, this is also the date used for the posted accounting transactions.

positions

(ProductPosition · object | DiscountPosition · object | TextPosition · object | SubtotalPosition · object)[]

required

The ordered list of positions on the document. At least one position is required, and discount positions must specify exactly one of percentage or amount.

A standard billable line item with a quantity, single amount, and contra account. Most invoice and estimate positions are of this type.

ProductPosition
DiscountPosition
TextPosition
SubtotalPosition

Show child attributes

isDraft

boolean

required

When true the estimate is saved as a draft.

template

string

The id of the invoice template to render the document with. When omitted while creating an invoice or estimate, the organisation's first template is used.

recipient

string

The id of the contact this document is addressed to. Required unless customRecipientText is provided.

customRecipientText

string

An ad-hoc recipient text used when no contact is associated with the document.

Maximum string length: 2000

externalReference

string

An optional reference for this document in an external system.

Maximum string length: 128

title

string

Optional document title displayed on the rendered output.

Maximum string length: 128

payableInDays

integer

Payment terms for this document in days from the opening date. Defaults to 30 on create.

Required range: 0 <= x <= 365

introductoryText

string

Text rendered above the positions.

Maximum string length: 2000

closingText

string

Text rendered below the positions.

Maximum string length: 2000

amountMode

enum<string>

Whether position amounts are entered gross (including VAT) or net (excluding VAT).

Available options:

gross,

net

language

enum<string>

The language used to render the document.

Available options:

de,

en,

fr,

it

columns

enum<string>[]

The columns to render in the positions table. If not provided the template default is used.

A column that can be shown on the rendered invoice or estimate.

Available options:

quantity,

unit,

articleNumber,

name,

date,

vatDebt,

vatRate,

singleAmount,

totalAmount,

discountRate,

positionNumber,

customTextColumn1,

customTextColumn2,

customTextColumn3

originalCurrency

string

For foreign-currency documents: the 3-character ISO 4217 currency code the document is denominated in. Must be a currency code that is enabled in the organisation. When set without exchangeRate, the organisation's stored exchange rate for that currency is used.

Required string length: 3

exchangeRate

number

For foreign-currency documents: the conversion rate from the original currency to the primary accounting currency, expressed as 1 originalCurrency = X primaryCurrency. Optional when originalCurrency is set; if omitted, defaults to the organisation's stored exchange rate for that currency. Cannot be set without originalCurrency.

Response

The estimate was created successfully.

estimate

Estimate · object

The full representation of an estimate (quote).

Show child attributes

Create estimate

curl --request POST \
  --url https://api.infinity.swiss/v1/estimates \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '
{
  "openingDate": "2023-12-25",
  "positions": [
    {
      "type": "product",
      "name": "<string>",
      "singleAmount": 12000,
      "quantity": 2,
      "contraAccount": 5499,
      "unit": "<string>",
      "taxCode": "",
      "articleNumber": "<string>",
      "description": "<string>",
      "date": "<string>",
      "discountRate": 50,
      "customTextColumns": {
        "customTextColumn1": "<string>",
        "customTextColumn2": "<string>",
        "customTextColumn3": "<string>"
      }
    }
  ],
  "isDraft": true,
  "template": "<string>",
  "recipient": "<string>",
  "customRecipientText": "<string>",
  "externalReference": "<string>",
  "title": "<string>",
  "payableInDays": 182,
  "introductoryText": "<string>",
  "closingText": "<string>",
  "columns": [],
  "originalCurrency": "<string>",
  "exchangeRate": 123
}
'

import requests

url = "https://api.infinity.swiss/v1/estimates"

payload = {
    "openingDate": "2023-12-25",
    "positions": [
        {
            "type": "product",
            "name": "<string>",
            "singleAmount": 12000,
            "quantity": 2,
            "contraAccount": 5499,
            "unit": "<string>",
            "taxCode": "",
            "articleNumber": "<string>",
            "description": "<string>",
            "date": "<string>",
            "discountRate": 50,
            "customTextColumns": {
                "customTextColumn1": "<string>",
                "customTextColumn2": "<string>",
                "customTextColumn3": "<string>"
            }
        }
    ],
    "isDraft": True,
    "template": "<string>",
    "recipient": "<string>",
    "customRecipientText": "<string>",
    "externalReference": "<string>",
    "title": "<string>",
    "payableInDays": 182,
    "introductoryText": "<string>",
    "closingText": "<string>",
    "columns": [],
    "originalCurrency": "<string>",
    "exchangeRate": 123
}
headers = {
    "x-api-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    openingDate: '2023-12-25',
    positions: [
      {
        type: 'product',
        name: '<string>',
        singleAmount: 12000,
        quantity: 2,
        contraAccount: 5499,
        unit: '<string>',
        taxCode: '',
        articleNumber: '<string>',
        description: '<string>',
        date: '<string>',
        discountRate: 50,
        customTextColumns: {
          customTextColumn1: '<string>',
          customTextColumn2: '<string>',
          customTextColumn3: '<string>'
        }
      }
    ],
    isDraft: true,
    template: '<string>',
    recipient: '<string>',
    customRecipientText: '<string>',
    externalReference: '<string>',
    title: '<string>',
    payableInDays: 182,
    introductoryText: '<string>',
    closingText: '<string>',
    columns: [],
    originalCurrency: '<string>',
    exchangeRate: 123
  })
};

fetch('https://api.infinity.swiss/v1/estimates', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.infinity.swiss/v1/estimates",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'openingDate' => '2023-12-25',
    'positions' => [
        [
                'type' => 'product',
                'name' => '<string>',
                'singleAmount' => 12000,
                'quantity' => 2,
                'contraAccount' => 5499,
                'unit' => '<string>',
                'taxCode' => '',
                'articleNumber' => '<string>',
                'description' => '<string>',
                'date' => '<string>',
                'discountRate' => 50,
                'customTextColumns' => [
                                'customTextColumn1' => '<string>',
                                'customTextColumn2' => '<string>',
                                'customTextColumn3' => '<string>'
                ]
        ]
    ],
    'isDraft' => true,
    'template' => '<string>',
    'recipient' => '<string>',
    'customRecipientText' => '<string>',
    'externalReference' => '<string>',
    'title' => '<string>',
    'payableInDays' => 182,
    'introductoryText' => '<string>',
    'closingText' => '<string>',
    'columns' => [
        
    ],
    'originalCurrency' => '<string>',
    'exchangeRate' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.infinity.swiss/v1/estimates"

	payload := strings.NewReader("{\n  \"openingDate\": \"2023-12-25\",\n  \"positions\": [\n    {\n      \"type\": \"product\",\n      \"name\": \"<string>\",\n      \"singleAmount\": 12000,\n      \"quantity\": 2,\n      \"contraAccount\": 5499,\n      \"unit\": \"<string>\",\n      \"taxCode\": \"\",\n      \"articleNumber\": \"<string>\",\n      \"description\": \"<string>\",\n      \"date\": \"<string>\",\n      \"discountRate\": 50,\n      \"customTextColumns\": {\n        \"customTextColumn1\": \"<string>\",\n        \"customTextColumn2\": \"<string>\",\n        \"customTextColumn3\": \"<string>\"\n      }\n    }\n  ],\n  \"isDraft\": true,\n  \"template\": \"<string>\",\n  \"recipient\": \"<string>\",\n  \"customRecipientText\": \"<string>\",\n  \"externalReference\": \"<string>\",\n  \"title\": \"<string>\",\n  \"payableInDays\": 182,\n  \"introductoryText\": \"<string>\",\n  \"closingText\": \"<string>\",\n  \"columns\": [],\n  \"originalCurrency\": \"<string>\",\n  \"exchangeRate\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.infinity.swiss/v1/estimates")
  .header("x-api-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"openingDate\": \"2023-12-25\",\n  \"positions\": [\n    {\n      \"type\": \"product\",\n      \"name\": \"<string>\",\n      \"singleAmount\": 12000,\n      \"quantity\": 2,\n      \"contraAccount\": 5499,\n      \"unit\": \"<string>\",\n      \"taxCode\": \"\",\n      \"articleNumber\": \"<string>\",\n      \"description\": \"<string>\",\n      \"date\": \"<string>\",\n      \"discountRate\": 50,\n      \"customTextColumns\": {\n        \"customTextColumn1\": \"<string>\",\n        \"customTextColumn2\": \"<string>\",\n        \"customTextColumn3\": \"<string>\"\n      }\n    }\n  ],\n  \"isDraft\": true,\n  \"template\": \"<string>\",\n  \"recipient\": \"<string>\",\n  \"customRecipientText\": \"<string>\",\n  \"externalReference\": \"<string>\",\n  \"title\": \"<string>\",\n  \"payableInDays\": 182,\n  \"introductoryText\": \"<string>\",\n  \"closingText\": \"<string>\",\n  \"columns\": [],\n  \"originalCurrency\": \"<string>\",\n  \"exchangeRate\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.infinity.swiss/v1/estimates")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"openingDate\": \"2023-12-25\",\n  \"positions\": [\n    {\n      \"type\": \"product\",\n      \"name\": \"<string>\",\n      \"singleAmount\": 12000,\n      \"quantity\": 2,\n      \"contraAccount\": 5499,\n      \"unit\": \"<string>\",\n      \"taxCode\": \"\",\n      \"articleNumber\": \"<string>\",\n      \"description\": \"<string>\",\n      \"date\": \"<string>\",\n      \"discountRate\": 50,\n      \"customTextColumns\": {\n        \"customTextColumn1\": \"<string>\",\n        \"customTextColumn2\": \"<string>\",\n        \"customTextColumn3\": \"<string>\"\n      }\n    }\n  ],\n  \"isDraft\": true,\n  \"template\": \"<string>\",\n  \"recipient\": \"<string>\",\n  \"customRecipientText\": \"<string>\",\n  \"externalReference\": \"<string>\",\n  \"title\": \"<string>\",\n  \"payableInDays\": 182,\n  \"introductoryText\": \"<string>\",\n  \"closingText\": \"<string>\",\n  \"columns\": [],\n  \"originalCurrency\": \"<string>\",\n  \"exchangeRate\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "estimate": {
    "id": "<string>",
    "isDraft": true,
    "number": "<string>",
    "organisation": "<string>",
    "template": "<string>",
    "openingDate": "2023-12-25",
    "dueDate": "2023-12-25",
    "positions": [
      {
        "type": "product",
        "name": "<string>",
        "singleAmount": 12000,
        "quantity": 2,
        "contraAccount": 5499,
        "id": "<string>",
        "unit": "<string>",
        "taxCode": "",
        "articleNumber": "<string>",
        "description": "<string>",
        "date": "<string>",
        "discountRate": 50,
        "customTextColumns": {
          "customTextColumn1": "<string>",
          "customTextColumn2": "<string>",
          "customTextColumn3": "<string>"
        },
        "totalAmount": 123,
        "vatDebt": 123,
        "originalCurrency": "<string>",
        "exchangeRate": 123
      }
    ],
    "totalAmount": 123,
    "totalNetAmount": 123,
    "totalVatDebt": 123,
    "status": "open",
    "recipient": "<string>",
    "customRecipientText": "<string>",
    "externalReference": "<string>",
    "title": "<string>",
    "payableInDays": 123,
    "introductoryText": "<string>",
    "closingText": "<string>",
    "amountMode": "gross",
    "language": "de",
    "originalCurrency": "<string>",
    "exchangeRate": 123,
    "columns": [
      "quantity"
    ],
    "emailDeliveries": [
      {
        "recipientEmail": "jsmith@example.com",
        "status": "<string>",
        "timestamp": "2023-11-07T05:31:56Z"
      }
    ],
    "publicPdfUrl": "<string>",
    "signingPerson": "<string>",
    "signedAt": "2023-11-07T05:31:56Z",
    "invoicesFromQuote": [
      "<string>"
    ]
  }
}

{
  "code": "<string>",
  "invalidFields": [
    "<string>"
  ]
}

{
  "code": "general/unauthorised"
}

{
  "code": "<string>"
}

{
  "code": "<string>"
}

For developers

MCP server

Accounting

Chart of accounts

Receipts

Contacts

Invoices

Estimates

Projects

Work entries

Creating an estimate

Example

Retrying safely with idempotency keys

Authorizations

Headers

Body

Response

​Creating an estimate

​Example

​Retrying safely with idempotency keys

Authorizations

Headers

Body

Response

Creating an estimate

Example

Retrying safely with idempotency keys