Skip to main content
GET
/
v2
/
quotes
List quotes
curl --request GET \
  --url https://thirdparty.qonto.com/v2/quotes \
  --header 'Authorization: Bearer <token>'
{
  "quotes": [
    {
      "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"
      ]
    }
  ],
  "meta": {
    "total": 123,
    "total_pages": 123,
    "current_page": 123,
    "next_page": 123,
    "prev_page": 123
  }
}

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.

Query Parameters

​
filter[status]
enum<string>[]

Quotes can be filtered by their status: Status can be one of: pending_approval, approved, canceled

Available options:
pending_approval,
approved,
canceled
​
filter[created_at_from]
string<date-time>

Quotes can be filtered by their created_at property. This filter can be used in combination with the created_at_to query parameter to get quotes created within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2022-02-01T12:01:02Z"

​
filter[created_at_to]
string<date-time>

Quotes can be filtered by their created_at property. This filter can be used in combination with the created_at_from query parameter to get quotes created within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2022-23-04T16:23:00Z"

​
page
integer

Returned page (cf. Pagination).

Example:

1

​
per_page
integer
default:100

Number of quotes per page (cf. Pagination).

Required range: x <= 500
​
sort_by
enum<string>
default:created_at:desc

Quotes can be sorted by their created_at property in 2 possible orders: asc (Ascending) / desc (Descending).

Available options:
created_at:desc,
created_at:asc

Response

Returns a list of quotes.

​
quotes
object[]
required
​
meta
object
required