---
title: "Show client invoice"
method: GET
path: "/v2/client_invoices/{id}"
tags: ["Client Invoices"]
---

# Show client invoice

`GET /v2/client_invoices/{id}`

OAuth scope: `client_invoices.read`

---

Retrieves a single client invoice.

## Headers

- `X-Qonto-Staging-Token` string

## Response `200`

Returns the client invoice (identified by the id specified in the URL).

- object
  - `client_invoice` ClientInvoice, required
    - `id` string, uuid, required
    - `organization_id` string, uuid, required
    - `attachment_id` string, uuid — Attachment UUID corresponding to that particular invoice. <br>When creating the invoice (by calling the [POST /v2/client_invoices](https://api-doc.qonto.com/docs/business-api/740572a1dd6f7-create-a-client-invoice) endpoint), the attachment is generated **asynchronously**; which means that you have to wait ~10s and then call the [GET /v2/client_invoices/{id}](https://api-doc.qonto.com/docs/business-api/copd6wc7nwym8-show-client-invoice) endpoint to get the `attachment_id`. <br>This attribute enables you to get the invoice file by using the [GET /v2/attachments/{id}](https://api-doc.qonto.com/docs/business-api/345dace7b485b-show-attachment) endpoint.
    - `number` string, required
    - `purchase_order` string, required — Purchase order data added by the invoice’s initiator.
    - `status` 'draft' | 'unpaid' | 'paid' | 'canceled', required
    - `invoice_url` string, uri, required — URL of the invoice public page, accessible without authentication for 180 days after issuance, provided the invoice has not been canceled.
    - `contact_email` string, email, required — E-mail address of the invoice’s initiator.
    - `terms_and_conditions` string, required — The T&C data added by the invoice’s initiator.
    - `discount_conditions` string, nullable, required — Any discount for advance payment of the invoice. It is optional and is only for French organizations.
    - `late_payment_penalties` string, nullable, required — Late payment penalties applied in case of non-payment invoice. It is optional and is only for French organizations.
    - `legal_fixed_compensation` string, nullable, required — The legal fixed compensation applied in case late payment of the invoice. It is optional and is only for French organizations.
    - `header` string, required — The header text added by the credit note’s initiator.
    - `footer` string, required — The footer text added by the credit note’s initiator.
    - `currency` string, required
    - `total_amount` object, required — Total amount that needs to be paid by the client.
      - `value` string
      - `currency` string
    - `total_amount_cents` integer, required — Total amount in cents that needs to be paid by the client.
    - `vat_amount` object, required — VAT amount that is applicable to the invoice.
      - `value` string
      - `currency` string
    - `vat_amount_cents` integer, required — VAT amount in cents that is applicable to the invoice.
    - `issue_date` string, date, required — Date the initiator mentioned that the invoice was created.
    - `due_date` string, date, required — Payment’s deadline added by the initiator.
    - `performance_date` string, date, required — Date the initiator mentioned that the contents of the invoice were performed.
    - `created_at` string, date-time, required — Date the invoice was created. Note that this is a machine date.
    - `finalized_at` string, date-time, required — Date the invoice was transitioned from `Draft` to `Unpaid` status.
    - `paid_at` string, date-time, required — Date on which the invoice was paid.
    - `stamp_duty_amount` string, required
    - `items` DocumentItem[], required
      - `title` string
      - `description` string
      - `quantity` string
      - `unit` string
      - `unit_price` object — Amount of the price per unit. Note that an item can contain multiple units. The number of units is defined via `quantity`.
        - `value` string
        - `currency` string
      - `unit_price_cents` integer — Amount in cents of the price per unit. Note that an item can contain multiple units. The number of units is defined via `quantity`.
      - `vat_rate` string — VAT rate in decimal (0.1 for 10%) applicable to that particular item.
      - `vat_exemption_reason` 'N1' | 'N2' | 'N2.1' | 'N2.2' | 'N3' | 'N3.1' | 'N3.2' | 'N3.3' | 'N3.4' | 'N3.5' | 'N3.6' | 'N4' | 'N5' | 'N6' | 'N6.1' | 'N6.2' | 'N6.3' | 'N6.4' | 'N6.5' | 'N6.6' | 'N6.7' | 'N6.8' | 'N6.9' | 'N7' | 'S293B' | 'S262.1' | 'S259' | 'S283' | 'S261' | 'S262' | 'S263' | 'S19.1' | 'S4.1B' | 'S4.1A' | 'S4' | 'S13B' | 'S122' | 'S25' | 'S21' | 'S69' | 'S20' | 'S84.1.2' — Exemption reason
      - `discount` object
        - `type` 'percentage' | 'absolute'
        - `value` string — Discount rate or absolute amount. For percentage, the minimum value is 0.0001 (0.01%), and the maximum value is 1 (100%). For absolute value, the maximum is determined by Quantity * Unit Price.
        - `amount` object
          - `value` string
          - `currency` string
      - `total_vat` object — VAT amount that is applicable to that specific item.
        - `value` string
        - `currency` string
      - `total_vat_cents` integer — VAT amount in cents that is applicable to that specific item.
      - `total_amount` object — Amount that needs to be paid by the client for that specific item.
        - `value` string
        - `currency` string
      - `total_amount_cents` integer — Amount in cents that needs to be paid by the client for that specific item.
      - `subtotal` object
        - `value` string — Subtotal amount for the item without VAT. Quantity * Unit_price.
        - `currency` string
      - `subtotal_cents` integer — Subtotal amount in cents for the item without VAT.
    - `client` EmbeddedClient, required — Client that needs to pay the invoice.
      - `id` string, uuid
      - `name` string — Note that this attribute will be returned only if the client is a `company`.
      - `first_name` string — Note that this attribute will be returned only if the client is an `individual` or a `freelancer`.
      - `last_name` string — Note that this attribute will be returned only if the client is an `individual` or a `freelancer`.
      - `type` 'individual' | 'company' | 'freelancer'
      - `email` string, email
      - `vat_number` string
      - `tax_identification_number` string
      - `address` string
      - `city` string
      - `zip_code` string
      - `province_code` string — Province code of the client. It is required only for Italian organizations
      - `country_code` string
      - `recipient_code` string — Recipient code, so that the client can receive the e-invoice in his SdI portal.
      - `locale` string
      - `billing_address` ClientBillingAddress — 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.
        - `street_address` string — Street address section of the billing address of the client (eg street, number, floor, door, etc).
        - `city` string — City on the billing address of the client
        - `zip_code` string — Zip code on the billing address of the client
        - `province_code` string — Province code of the client's billing address. It is required only for Italian organizations.
        - `country_code` string — Country code on the billing address of the client (ISO 3166 format)
      - `delivery_address` ClientDeliveryAddress
        - `street_address` string — Street address section of the delivery address of the client. (eg street, number, floor, door, etc)
        - `city` string — City on the delivery address of the client
        - `zip_code` string — Zip code on the delivery address of the client
        - `province_code` string — Province code of the client's delivery address. It is required only for Italian organizations
        - `country_code` string — Country code on the delivery address of the client (ISO 3166 format)
    - `payment_methods` object[], required
      - `beneficiary_name` string — Name of the beneficiary that will receive the invoice's payment.
      - `bic` string — Beneficiary’s International Bank Account Number.
      - `iban` string — Beneficiary account's Bank Identifier.
      - `type` 'transfer' — Invoice's payment method.
    - `credit_notes_ids` string[], required — If any credit notes are linked to the invoice, this represents the id of those credit notes.
    - `organization` EmbeddedInvoiceOrganization, required — Information of the organization at the time the document was issued.
      - `id` string, uuid
      - `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` string
      - `district_court` string
      - `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.
      - `vat_number` string
      - `tax_number` string
      - `legal_capital_share` object — Capital share of an incorporated business. It is optional and is only for French organizations.
        - `value` string
        - `currency` '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'
      - `transaction_type` 'goods' | 'services' | 'goods_and_services' — Type of transaction performed in the invoice. It is optional and is only for French organizations.
      - `vat_payment_condition` 'on_receipts' | 'compensated_for_sales' | 'exempt' — 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.
    - `einvoicing_status` 'pending' | 'submitted' | 'declined' | 'approved' | 'not_delivered' | 'submission_failed'
    - `welfare_fund` object
      - `type` 'TC01' | 'TC02' | 'TC03' | 'TC04' | 'TC05' | 'TC06' | 'TC07' | 'TC08' | 'TC09' | 'TC10' | 'TC11' | 'TC12' | 'TC13' | 'TC14' | 'TC15' | 'TC16' | 'TC17' | 'TC18' | 'TC19' | 'TC20' | 'TC21' | 'TC22'
      - `rate` string
    - `withholding_tax` object — - Only applicable for Italian organizations and Spanish freelancers. - Object which relates to an amount of tax paid by the client, rather than the supplier, for specific cases. - This amount is a percentage deducted from the total amount of the invoice after VAT application. - The `rate` field specifies the percentage of tax and `amount` field specifies the total amount of the tax.
      - `reason` 'RF01' | 'RF02' | 'RF03' | 'RF04' | 'RF05' | 'RF06'
      - `rate` string
      - `payment_reason` string
      - `amount` string
    - `payment_reporting` object
      - `conditions` 'TP01' | 'TP02' | 'TP03'
      - `method` 'MP01' | 'MP02' | 'MP03' | 'MP04' | 'MP05' | 'MP06' | 'MP07' | 'MP08' | 'MP09' | 'MP10' | 'MP11' | 'MP12' | 'MP13' | 'MP14' | 'MP15' | 'MP16' | 'MP17' | 'MP18' | 'MP19' | 'MP20' | 'MP21' | 'MP22'

## Other responses

- `400` — Returns a bad request error.
- `401` — Returns an unauthorized error.
- `403` — Returns a forbidden error.
- `422` — Returns an unprocessable entity error.

---

[API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/versions/25208d6f9deb/schema)