Skip to main content
POST
/
v2
/
quotes
Create a quote
curl --request POST \
  --url https://thirdparty.qonto.com/v2/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "issue_date": "2024-01-15",
  "expiry_date": "2024-02-15",
  "number": "Q-2024-001",
  "terms_and_conditions": "<string>",
  "currency": "EUR",
  "header": "<string>",
  "footer": "<string>",
  "settings": {
    "vat_number": "<string>",
    "district_court": "<string>",
    "company_leadership": "<string>",
    "commercial_register_number": "<string>",
    "tax_number": "<string>"
  },
  "discount": {
    "type": "percentage",
    "value": "10"
  },
  "items": [
    {
      "title": "<string>",
      "description": "<string>",
      "currency": "EUR",
      "quantity": "2.5",
      "unit": "hour",
      "unit_price": {
        "value": "100.00",
        "currency": "EUR"
      },
      "vat_rate": "20",
      "discount": {
        "type": "percentage",
        "value": "5"
      },
      "vat_exemption_reason": "N1"
    }
  ],
  "welfare_fund": {
    "type": "TC22",
    "rate": "0.1"
  },
  "withholding_tax": {
    "reason": "RT01",
    "rate": "0.1",
    "payment_reason": "M1"
  },
  "stamp_duty_amount": "0.1"
}'
{
  "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "attachment_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "number": "Q-2024-001",
  "status": "pending_approval",
  "quote_url": "https://portal.qonto.com/quotes/00000000-0000-0000-0000-000000000000",
  "contact_email": "contact@qonto.com",
  "terms_and_conditions": "This is an example.",
  "header": "This is an example.",
  "footer": "This is an example.",
  "currency": "EUR",
  "discount": {
    "type": "percentage",
    "value": "10",
    "amount": {
      "value": "20.00",
      "currency": "EUR"
    },
    "amount_cents": 2000
  },
  "total_amount": {
    "value": "240.00",
    "currency": "EUR"
  },
  "total_amount_cents": 24000,
  "vat_amount": {
    "value": "40.00",
    "currency": "EUR"
  },
  "vat_amount_cents": 4000,
  "issue_date": "2024-01-15",
  "expiry_date": "2024-02-15",
  "created_at": "2024-01-15T10:30:00Z",
  "approved_at": "2024-01-16T14:22:00Z",
  "canceled_at": "2024-01-17T09:15:00Z",
  "welfare_fund": {
    "type": "TC22",
    "rate": "0.1",
    "amount": "10.00"
  },
  "withholding_tax": {
    "reason": "RT01",
    "rate": "0.1",
    "amount": "10.00",
    "payment_reason": "M1"
  },
  "stamp_duty_amount": "0.10",
  "items": [
    {
      "title": "Consulting services",
      "description": "Monthly consulting services",
      "quantity": "2.5",
      "unit": "hour",
      "vat_rate": "20",
      "vat_exemption_reason": "N1",
      "unit_price": {
        "value": "100.00",
        "currency": "EUR"
      },
      "unit_price_cents": 10000,
      "total_amount": {
        "value": "200.00",
        "currency": "EUR"
      },
      "total_amount_cents": 20000,
      "total_vat": {
        "value": "40.00",
        "currency": "EUR"
      },
      "total_vat_cents": 4000,
      "subtotal": {
        "value": "160.00",
        "currency": "EUR"
      },
      "subtotal_cents": 16000,
      "discount": {
        "type": "percentage",
        "value": "<string>",
        "amount": {
          "value": "<string>",
          "currency": "<string>"
        },
        "amount_cents": 123
      }
    }
  ],
  "client": {
    "id": "33v418bb-bd0d-4df4-865c-c07afab8bb48",
    "name": "McDonald's",
    "first_name": "Jane",
    "last_name": "Doe",
    "type": "individual",
    "email": "client@qonto.com",
    "vat_number": "FR32123456789",
    "tax_identification_number": "123456789",
    "address": "1 place de l’Opéra",
    "city": "Paris",
    "zip_code": "75009",
    "province_code": "<string>",
    "country_code": "fr",
    "recipient_code": "<string>",
    "locale": "fr",
    "billing_address": {
      "street_address": "123 Main Street",
      "city": "Paris",
      "zip_code": "75009",
      "province_code": "<string>",
      "country_code": "FR"
    },
    "delivery_address": {
      "street_address": "123 Main Street",
      "city": "Paris",
      "zip_code": "75009",
      "province_code": "<string>",
      "country_code": "FR"
    }
  },
  "organization": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "legal_name": "<string>",
    "legal_number": "<string>",
    "legal_country": "<string>",
    "address_line_1": "<string>",
    "address_line_2": "<string>",
    "address_zipcode": "<string>",
    "address_city": "<string>",
    "address_country": "<string>",
    "company_leadership": "Jan Mueller",
    "district_court": "Munich",
    "commercial_register_number": "HRB12345B",
    "vat_number": "FR123456789",
    "tax_number": "123/123/1234",
    "legal_capital_share": {
      "value": "10000.00",
      "currency": "EUR"
    },
    "transaction_type": "goods",
    "vat_payment_condition": "on_receipts"
  },
  "invoice_ids": [
    "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

​
X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Body

application/json
​
client_id
string<uuid>
required

Client ID

​
issue_date
string<date>
required

Issue date in YYYY-MM-DD format

Example:

"2024-01-15"

​
expiry_date
string<date>
required

Expiry date in YYYY-MM-DD format

Example:

"2024-02-15"

​
terms_and_conditions
string
required

Terms and conditions text

Maximum length: 3000
​
currency
string
required

Currency code (ISO 4217, alpha 3)

Example:

"EUR"

​
items
object[]
required

Quote's line items

Minimum length: 1
​
number
string

Quote's number. Must be unique within the organization and is:

  • required if automatic numbering is disabled for the authenticated organization (default setting);
  • optional if automatic numbering is enabled for the authenticated organization. However, if provided, it will be used as the quote's number.
Maximum length: 40
Example:

"Q-2024-001"

​
header
string

Optional header text for the quote.

Maximum length: 1000
​
footer
string

Optional footer text for the quote.

Maximum length: 1000
​
settings
object

This collection of propertys can be optionally used to temporarily override some of the organization's properties for this one invoice.

​
discount
object

Global discount applied to the quote

​
welfare_fund
object

Welfare fund details (Italian specific)

​
withholding_tax
object

Withholding tax details (Italian specific)

​
stamp_duty_amount
string

Stamp duty amount (Italian specific)

Example:

"0.1"

Response

Returns the created quote.

​
id
string<uuid>
required

Quote ID

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

​
organization_id
string<uuid>
required

Organization ID

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

​
number
string
required

Quote number

Example:

"Q-2024-001"

​
status
enum<string>
required

Quote status

Available options:
pending_approval,
approved,
canceled
Example:

"pending_approval"

​
currency
string
required

Currency code (ISO 4217 format, alpha 3)

Example:

"EUR"

​
total_amount
object
required

Total amount of the quote

​
total_amount_cents
integer
required

Total amount in cents

Example:

24000

​
vat_amount
object
required

VAT amount of the quote

​
vat_amount_cents
integer
required

VAT amount in cents

Example:

4000

​
issue_date
string<date>
required

Issue date (YYYY-MM-DD)

Example:

"2024-01-15"

​
expiry_date
string<date>
required

Expiry date (YYYY-MM-DD)

Example:

"2024-02-15"

​
created_at
string<date-time>
required

Creation timestamp

Example:

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

​
items
object[]
required

Quote line items

​
client
object
required

Client that needs to pay the invoice.

​
organization
object
required

Information of the organization at the time the document was issued.

​
attachment_id
string<uuid>

Attachment ID for the quote PDF

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

​
quote_url
string<uri>

Public URL to view the quote

Example:

"https://portal.qonto.com/quotes/00000000-0000-0000-0000-000000000000"

​
contact_email
string<email>

Organization contact email

Example:

"contact@qonto.com"

​
terms_and_conditions
string

Terms and conditions text

Example:

"This is an example."

​
header
string

Header text for the quote

Example:

"This is an example."

​
footer
string

Footer text for the quote

Example:

"This is an example."

​
discount
object

Global discount applied to the quote

​
approved_at
string<date-time>

Approval timestamp (if approved)

Example:

"2024-01-16T14:22:00Z"

​
canceled_at
string<date-time>

Cancellation timestamp (if canceled)

Example:

"2024-01-17T09:15:00Z"

​
welfare_fund
object

Welfare fund details (Italian specific)

​
withholding_tax
object

Withholding tax details (Italian specific)

​
stamp_duty_amount
string

Stamp duty amount (Italian specific)

Example:

"0.10"

​
invoice_ids
string<uuid>[]

IDs of invoices created from this quote