Docs API Reference Ecommerce/bff/ecommerce/vies/detail

/bff/ecommerce/vies/detail

Validates an EU VAT identifier through the VIES REST API and caches the result for 4 weeks. Returns the validity flag, registered name, address, the VIES request date, and a UI hint (suggestReverseCharge) that is true for valid non-CZ EU VAT IDs — the typical case where the admin should set the contact's reverseCharge flag.

EcommercegetBffEcommerceViesDetail

Parameters

2 query

2 total

Query · 2

vatIdstringRequired

EU VAT identifier including country prefix (e.g., "SK2020317068").

forcestring

Set to "true" to bypass the 4-week cache and re-query VIES.

Request

GET /bff/ecommerce/vies/detail

get

curl -X GET "https://api.bizkithub.com/bff/ecommerce/vies/detail?vatId=SK2020317068&force=example_force" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

JSON payload

{
  "vatId": "example_vatId",
  "isValid": false,
  "countryCode": "example_countryCode",
  "vatNumber": "example_vatNumber",
  "name": "example_name",
  "address": "example_address",
  "requestDate": "example_requestDate",
  "suggestReverseCharge": false
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key