VIES

VIES

Deprecated: Use the Transaction Type endpoint instead.
VIES (VAT Information Exchange System) validation for EU tax numbers.

Endpoints

IntroductionPOST/vies/check

Check VIES status (deprecated)

POST/vies/check

Deprecated: Use POST /transaction-type/check instead. This endpoint is kept for backward compatibility.

This endpoint never selects an entity. When items are sent, a line's own classification is used, but a line that only has an item_id cannot take its classification from the catalog here and counts as unclassified. Use POST /transaction-type/check with the entity selected for that.

Request

Body parameters

issuerobjectrequiredShow child attributes

Issuer (seller) information

customerobjectrequiredShow child attributes

Customer (buyer) information

Other parametersExpand all

supply_typestringoptionalnullable

itemsarray of objectsoptionalnullableShow child attributes

refreshbooleanoptionalnullable

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

import SpaceInvoices from '@spaceinvoices/js-sdk/sdk';

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.vies.checkVies({
  issuer: {
    country_code: "SI",
    is_tax_subject: true
  },
  customer: {
    country_code: "DE",
    tax_number: "DE123456789"
  }
}, {
  entity_id: "YOUR_ENTITY_ID"
});

console.log(response);

Response

Returns

transaction_typestringnullable

reverse_charge_appliesboolean

issuer_country_codestringnullable

customer_country_codestringnullable

vies_validbooleannullable

warningstringnullable

warning_codestring

warning_last_valid_datestring<date>

is_tax_subjectboolean

hmrc_validbooleannullable

vat_id_country_codestringnullable

supply_scopestringnullable

json

Copy

{
  "transaction_type": "intra_eu_b2b",
  "reverse_charge_applies": true,
  "issuer_country_code": "SI",
  "customer_country_code": "DE",
  "vies_valid": true,
  "warning": null,
  "is_tax_subject": true
}

---