Validate VAT registration number for EU customers

Verify the validity of a VAT registration number for customers within the EU. This is particularly useful when registering new accounts or updating billing information to ensure correct VAT accounting. The endpoint returns a unique ID for subsequent calls related to billing or administration.

Headers

Accept Example

Content-Type Example

Body

required

application/json

countryCode string · enum required

AT

EE

ES

FI

HU

IT

NL

PL

PT

RO

SE

vatNumber string required

Responses

200

success boolean

timestamp string

requestId string

data object

POST https://cloud.hostup.se/api/validate-vat

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/validate-vat" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "countryCode": "AT",
    "vatNumber": "string"
  }'

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "valid": true,
    "vatNumber": "string",
    "countryCode": "string",
    "name": "string",
    "address": "string",
    "requestDate": "string",
    "error": "string",
    "errorCode": "string",
    "verifiedByVIES": true,
    "viesUnavailable": true
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "valid": {
          "type": "boolean"
        },
        "vatNumber": {
          "type": "string"
        },
        "countryCode": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "address": {
          "type": "string"
        },
        "requestDate": {
          "type": "string"
        },
        "error": {
          "type": "string",
          "nullable": true
        },
        "errorCode": {
          "type": "string",
          "nullable": true
        },
        "verifiedByVIES": {
          "type": "boolean"
        },
        "viesUnavailable": {
          "type": "boolean"
        }
      }
    }
  }
}

Request Body

{
  "countryCode": "AT",
  "vatNumber": "string"
}