VIES

VIES

VIES (VAT Information Exchange System) validation for EU tax numbers.
Check transaction type and reverse charge applicability based on issuer and customer information.

Endpoints

POST/vies/check

Check VIES status

POST/vies/check

Check transaction type and reverse charge applicability based on issuer and customer information.

Country Resolution:
- Country names are automatically resolved to ISO country codes (handles variations like "Slovenija" → "SI")
- If both country and country_code are provided, country_code takes precedence

Transaction Types:
- domestic: Same country for issuer and customer
- intra_eu_b2b: Cross-border EU sale to business with valid tax number
- intra_eu_b2c: Cross-border EU sale to consumer (no tax number)
- export: Sale outside EU

Reverse Charge:
Applies when:
- Issuer is an EU tax subject
- Customer is in a different EU country
- Customer has a valid tax number (verified via VIES)

Non-Tax Subjects:
When issuer.is_tax_subject is false, all transactions are treated as B2C (no VIES validation, no reverse charge).

Request

Body parameters

issuerobjectrequiredShow child attributes

Issuer (seller) information

customerobjectrequiredShow child attributes

Customer (buyer) information

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

curl -X POST "https://eu.spaceinvoices.com/vies/check" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "issuer": {
      "country": "Slovenia",
      "is_tax_subject": true
    },
    "customer": {
      "country": "Germany",
      "tax_number": "DE123456789"
    }
  }'

Example:

IntraEuB2BDomestic

Response

Returns

transaction_typestring

reverse_charge_appliesboolean

issuer_country_codestring

customer_country_codestring

vies_validboolean

warningstring

is_tax_subjectboolean

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
}

Example:

IntraEuB2BDomestic

---