Retrieve a quote

curl --request GET \
  --url https://thirdparty.qonto.com/v2/quotes/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "number": "Q-2024-001",
  "status": "pending_approval",
  "currency": "EUR",
  "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",
  "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": "[email protected]",
    "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"
  },
  "attachment_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "quote_url": "https://portal.qonto.com/quotes/00000000-0000-0000-0000-000000000000",
  "contact_email": "[email protected]",
  "terms_and_conditions": "This is an example.",
  "header": "This is an example.",
  "footer": "This is an example.",
  "discount": {
    "type": "percentage",
    "value": "10",
    "amount": {
      "value": "20.00",
      "currency": "EUR"
    },
    "amount_cents": 2000
  },
  "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",
  "invoice_ids": [
    "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
  ]
}

GET

quotes

{id}

Retrieve a quote

curl --request GET \
  --url https://thirdparty.qonto.com/v2/quotes/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "number": "Q-2024-001",
  "status": "pending_approval",
  "currency": "EUR",
  "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",
  "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": "[email protected]",
    "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"
  },
  "attachment_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "quote_url": "https://portal.qonto.com/quotes/00000000-0000-0000-0000-000000000000",
  "contact_email": "[email protected]",
  "terms_and_conditions": "This is an example.",
  "header": "This is an example.",
  "footer": "This is an example.",
  "discount": {
    "type": "percentage",
    "value": "10",
    "amount": {
      "value": "20.00",
      "currency": "EUR"
    },
    "amount_cents": 2000
  },
  "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",
  "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.

Path Parameters

string<uuid>

required

The unique identifier of the quote.

Response

Returns the quote identified by the id path parameter.

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

Show child attributes

total_amount.value

string

Example:

"240.00"

total_amount.currency

string

Example:

"EUR"

total_amount_cents

integer<int64>

required

Total amount in cents

Example:

24000

vat_amount

object

required

VAT amount of the quote

Show child attributes

vat_amount.value

string

Example:

"40.00"

vat_amount.currency

string

Example:

"EUR"

vat_amount_cents

integer<int64>

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

Show child attributes

items.title

string

Item title

Example:

"Consulting services"

items.description

string

Item description

Example:

"Monthly consulting services"

items.quantity

string

Quantity

Example:

"2.5"

items.unit

string

Unit of measurement

Example:

"hour"

items.vat_rate

string

VAT rate percentage

Example:

"20"

items.vat_exemption_reason

string

VAT exemption code (Italian specific)

Example:

"N1"

items.unit_price

object

Show child attributes

items.unit_price.value

string

Example:

"100.00"

items.unit_price.currency

string

Example:

"EUR"

items.unit_price_cents

integer<int64>

Example:

10000

items.total_amount

object

Show child attributes

items.total_amount.value

string

Example:

"200.00"

items.total_amount.currency

string

Example:

"EUR"

items.total_amount_cents

integer<int64>

Example:

20000

items.total_vat

object

Show child attributes

items.total_vat.value

string

Example:

"40.00"

items.total_vat.currency

string

Example:

"EUR"

items.total_vat_cents

integer<int64>

Example:

4000

items.subtotal

object

Show child attributes

items.subtotal.value

string

Example:

"160.00"

items.subtotal.currency

string

Example:

"EUR"

items.subtotal_cents

integer<int64>

Example:

16000

items.discount

object

Show child attributes

items.discount.type

enum<string>

Available options:

percentage,

amount

items.discount.value

string

items.discount.amount

object

Show child attributes

items.discount.amount.value

string

items.discount.amount.currency

string

items.discount.amount_cents

integer<int64>

client

object

required

Client that needs to pay the invoice.

Show child attributes

client.id

string<uuid>

Example:

"33v418bb-bd0d-4df4-865c-c07afab8bb48"

client.name

string

Note that this property will be returned only if the client is a company.

Example:

"McDonald's"

client.first_name

string

Note that this property will be returned only if the client is an individual or a freelancer.

Example:

"Jane"

client.last_name

string

Note that this property will be returned only if the client is an individual or a freelancer.

Example:

"Doe"

client.type

enum<string>

Available options:

individual,

company,

freelancer

Example:

"individual"

client.email

string<email>

Example:

"[email protected]"

client.vat_number

string

Example:

"FR32123456789"

client.tax_identification_number

string

Example:

"123456789"

client.address

string

Example:

"1 place de l’Opéra"

client.city

string

Example:

"Paris"

client.zip_code

string

Example:

"75009"

client.province_code

string

Province code of the client. It is required only for Italian organizations

client.country_code

string

Example:

"fr"

client.recipient_code

string

Recipient code, so that the client can receive the e-invoice in his SdI portal.

client.locale

string

Example:

"fr"

client.billing_address

object

Billing address of the client, which will be reflected on the invoice. Stores the same data as the root-level fields address fields (address, city, zip_code, province_code, country_code). Send either a billing_address object filled-in or individual root-level address fields (address, city, zip_code, province_code, country_code). When both are sent, billing_address takes precedence and overwrites root-level fields.

Show child attributes

client.billing_address.street_address

string

Street address section of the billing address of the client (eg street, number, floor, door, etc).

Maximum string length: 250

Example:

"123 Main Street"

client.billing_address.city

string

City on the billing address of the client

Maximum string length: 50

Example:

"Paris"

client.billing_address.zip_code

string

Zip code on the billing address of the client

Maximum string length: 20

Example:

"75009"

client.billing_address.province_code

string

Province code of the client's billing address. It is required only for Italian organizations.

Maximum string length: 2

client.billing_address.country_code

string

Country code on the billing address of the client (ISO 3166 format)

Maximum string length: 2

Example:

"FR"

client.delivery_address

object

Delivery address of the client. Stores the same data as the root-level fields address fields (address, city, zip_code, province_code, country_code).

Show child attributes

client.delivery_address.street_address

string

Street address section of the delivery address of the client. (eg street, number, floor, door, etc)

Maximum string length: 250

Example:

"123 Main Street"

client.delivery_address.city

string

City on the delivery address of the client

Maximum string length: 50

Example:

"Paris"

client.delivery_address.zip_code

string

Zip code on the delivery address of the client

Maximum string length: 20

Example:

"75009"

client.delivery_address.province_code

string

Province code of the client's delivery address. It is required only for Italian organizations

Maximum string length: 2

client.delivery_address.country_code

string

Country code on the delivery address of the client (ISO 3166 format)

Maximum string length: 2

Example:

"FR"

organization

object

required

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

Show child attributes

organization.id

string<uuid>

organization.legal_name

string

organization.legal_number

string

organization.legal_country

string

organization.address_line_1

string

organization.address_line_2

string

organization.address_zipcode

string

organization.address_city

string

organization.address_country

string

organization.company_leadership

string

Example:

"Jan Mueller"

organization.district_court

string

Example:

"Munich"

organization.commercial_register_number

string

Is available for French and German organizations and is optional.

For French organizations, it represents RCS number (numéro Registre du Commerce et des Sociétés) of an incorporated business. For example: RCS A 123 123 123.
For German organizations, it represents the organization's commercial register number (handelsregisternummer). For example: HRB 123455 B.

Example:

"HRB12345B"

organization.vat_number

string

Example:

"FR123456789"

organization.tax_number

string

Example:

"123/123/1234"

Capital share of an incorporated business. It is optional and is only for French organizations.

Show child attributes

Maximum string length: 12

Example:

"10000.00"

Available options:

AED,

AUD,

BGN,

CAD,

CHF,

CNY,

CZK,

DKK,

EUR,

GBP,

GHS,

HKD,

HUF,

ILS,

MXN,

NOK,

NZD,

PEN,

PLN,

RON,

RSD,

SAR,

SEK,

SGD,

TRY,

USD,

ZAR,

ZMW

Example:

"EUR"

organization.transaction_type

enum<string>

Type of transaction performed in the invoice. It is optional and is only for French organizations.

Available options:

goods,

services,

goods_and_services

Example:

"goods"

organization.vat_payment_condition

enum<string>

Business’ VAT elected payment condition (whether TVA is paid on receipt or on invoice emission). There are two allowed values:

receipt which stands for “sur les encaissements” in French;
compensated_for_sales which stands for “sur les débits” in French. It is optional and is only for French organizations.

Available options:

on_receipts,

compensated_for_sales,

exempt

Example:

"on_receipts"

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:

"[email protected]"

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

Show child attributes

discount.type

enum<string>

Discount type

Available options:

percentage,

amount

Example:

"percentage"

discount.value

string

Discount value

Example:

"10"

discount.amount

object

Show child attributes

discount.amount.value

string

Example:

"20.00"

discount.amount.currency

string

Example:

"EUR"

discount.amount_cents

integer<int64>

Example:

2000

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)

Show child attributes

welfare_fund.type

string

Example:

"TC22"

welfare_fund.rate

string

Example:

"0.1"

welfare_fund.amount

string

Example:

"10.00"

withholding_tax

object

Withholding tax details (Italian specific)

Show child attributes

withholding_tax.reason

string

Example:

"RT01"

withholding_tax.rate

string

Example:

"0.1"

withholding_tax.amount

string

Example:

"10.00"

withholding_tax.payment_reason

string

Example:

"M1"

stamp_duty_amount

string

Stamp duty amount (Italian specific)

Example:

"0.10"

invoice_ids

string<uuid>[]

IDs of invoices created from this quote

Create a quote Update a quote

⌘I

Business API

Onboarding API

Retrieve a quote

Authorizations

Headers

Path Parameters

Response