---
title: "POST /invoice/{invoice_id}/submit"
method: POST
path: "/invoice/{invoice_id}/submit"
tags: ["Invoice"]
---

# POST /invoice/{invoice_id}/submit

`POST /invoice/{invoice_id}/submit`

Submit an invoice for validation by Defacto (with status TO_SUBMIT or TO_EDIT).
If some data is missing prior to validating the invoice, a 422 error will be returned with the list of the missing fields.

## Path parameters

- `invoice_id` string, required

## Request body

- APIPatchInvoice
  - `buyer` APICounterpartyCreation
    - `address` Address
      - `address_line_1` string, nullable
      - `address_line_2` string, nullable
      - `city` string, nullable
      - `country` string, nullable
      - `postal_code` string, nullable
      - `state` string, nullable
    - `contact` APICounterpartyContact
      - `email` string, email, required
      - `first_name` string, required
      - `last_name` string, required
      - `phone_number` string, required
    - `identifier` string, nullable — Legal identifier of the business, such as its SIRET or SIREN in France. Must not contain spaces.
    - `identifier_type` 'belgium_registration_number' | 'bsn' | 'cif' | 'hr_nummer' | 'kvk' | 'name' | 'nif' | 'siren' | 'siret' | 'steuernummer' | 'vat_number' | 'null', nullable — Type of legal business identifier of the business, such as the SIRET in France.
    - `name` string, nullable — Legal name of the business.
    - `vat_number` string, nullable — VatNumber
  - `currency` 'EUR' | 'GBP' | 'null', nullable — Currency of the invoice. Use ISO 4217 currency code.
  - `due_at` string, date-time, nullable
  - `invoice_number` string, nullable — Invoice number as displayed on the invoice
  - `issued_at` string, date-time, nullable
  - `metadata` object, nullable — This object is yours, it enables you to add custom data.
  - `net_amount` integer, nullable — Amount before tax, in cents
  - `seller` APICounterpartyCreation
    - `address` Address
      - `address_line_1` string, nullable
      - `address_line_2` string, nullable
      - `city` string, nullable
      - `country` string, nullable
      - `postal_code` string, nullable
      - `state` string, nullable
    - `contact` APICounterpartyContact
      - `email` string, email, required
      - `first_name` string, required
      - `last_name` string, required
      - `phone_number` string, required
    - `identifier` string, nullable — Legal identifier of the business, such as its SIRET or SIREN in France. Must not contain spaces.
    - `identifier_type` 'belgium_registration_number' | 'bsn' | 'cif' | 'hr_nummer' | 'kvk' | 'name' | 'nif' | 'siren' | 'siret' | 'steuernummer' | 'vat_number' | 'null', nullable — Type of legal business identifier of the business, such as the SIRET in France.
    - `name` string, nullable — Legal name of the business.
    - `vat_number` string, nullable — VatNumber
  - `tax_amount` integer, nullable — Amount of tax, in cents
  - `to_account` APIAccountCreation
    - `account_holder` APIBusinessIdentifier
      - `identifier` string, required — Legal identifier of the business, such as its SIRET or SIREN in France. Must not contain spaces.
      - `identifier_type` 'belgium_registration_number' | 'bsn' | 'cif' | 'hr_nummer' | 'kvk' | 'name' | 'nif' | 'siren' | 'siret' | 'steuernummer' | 'vat_number', required — Type of legal business identifier of the business, such as the SIRET in France.
    - `account_number` string, required — The account identifier. Only IBANs are supported at the moment.
    - `account_number_type` 'account_number' | 'iban' | 'internal_id' — The type of account number (e.g. IBAN).
    - `bank_identifier` string, nullable — The identifier of the bank.
    - `bank_identifier_type` 'bic' | 'name' | 'routing_number' | 'undefined' — The type of bank identifier (e.g. BIC).
  - `to_pay_amount` integer, nullable — Remaining amount due by buyer to seller, in cents. Set at 0 for fully paid invoices.
  - `total_amount` integer, nullable — Sum of net amount and tax amount, in cents

## Response `200`

OK

---

[API](https://skmtc.net/getdefacto/apis/api-reference.md) · [All operations](https://skmtc.net/getdefacto/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdefacto/api-reference/revisions/0a9c1f8784f2/schema)