Check one invoice party
check_partyRead-onlyIdempotent
Check exactly one seller or buyer's registry identifiers and readiness through EU Verify.
Use to correct one party's identifiers; use check_invoice_parties to check seller and buyer together,
or validate_invoice for document rules.
Supply siren, siret or vat; siret wins over siren. A SIREN/SIRET, country_code=FR or FR VAT triggers
French checks requiring a SIREN/SIRET. Omitted vat can be derived from a successful French lookup;
foreign parties normally need explicit VAT. Send address fields with a coherent country_code;
requester_vat cannot substitute for the checked party's vat.
Sends supplied fields to EU Verify and applicable registers. A Pro/Scale key enables checks;
other plans return plan_excluded. No Factur-X document quota is consumed.
Returns status, reasons with field pointers and available evidence: invoice_ready is positive,
not_ready needs correction, upstream_unavailable is inconclusive and retryable, invalid_input
indicates rejected input. Register results and evidence ids may change between calls.
No invoice is created or stored.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vat | No | Party's EU VAT number, for example FR40732829320. | |
| city | No | City, checked with the address. | |
| eori | No | EORI. Checked only when you send it. | |
| iban | No | Party IBAN. Checked only when you send it. | |
| role | No | Party role recorded in the evidence; defaults to buyer. | buyer |
| siren | No | 9-digit French SIREN, including leading zeros. | |
| siret | No | 14-digit French SIRET, including leading zeros. | |
| address | No | Street line; any address, postal_code or city activates address checking. | |
| postal_code | No | Postal code, checked with the address. | |
| country_code | No | ISO 3166-1 alpha-2 country code, for example FR or DE. | |
| requester_vat | No | Your VAT number, so the evidence pack can include a VIES request identifier. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||