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": {
        "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"
  },
  "attachment_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "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.",
  "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": {
        "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"
  },
  "attachment_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
  "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.",
  "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_cents

integer<int64>

required

Total amount in cents

Example:

24000

vat_amount

object

required

VAT amount of the quote

Show child attributes

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

client

object

required

Client that needs to pay the invoice.

Show child attributes

organization

object

required

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

Show child attributes

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

Show child attributes

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

withholding_tax

object

Withholding tax details (Italian specific)

Show child attributes

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