vatcheckapi

https://vatcheckapi.com/docs
Admin
vatcheckapi validates VAT numbers and looks up their registration details over a simple JSON REST...
Tokens:10,652
Snippets:95
Trust Score:8.1
Update:1 month ago
Show doc for...
Tokens:
Raw
### VAT validation response example

Source: https://vatcheckapi.com/docs/check.html

Example JSON response from the VAT Check API showing company details and registration info history.

```json
{
    "name": "AMAZON EUROPE CORE S.A R.L.",
    "address": "38, AVENUE JOHN F. KENNEDY\nL-1855  LUXEMBOURG",
    "address_parts": null,
    "checked_at": "2023-01-11T12:30:28.000000Z"
},
    "registration_info_history": []
}
```

--------------------------------

### Sample response for VAT validation

Source: https://vatcheckapi.com/docs/llms-full.txt

Example response from the v2 check endpoint for a valid VAT number. Shows the country code, VAT number, format and checksum validity flags, and registration details including company name and address. The registration_info_history field is an empty array in this example.

```json
{
    "country_code": "LU",
    "vat_number": "26375245",
    "format_valid": true,
    "checksum_valid": true,
    "registration_info": {
        "is_registered": true,
        "name": "AMAZON EUROPE CORE S.A R.L.",
        "address": "38, AVENUE JOHN F. KENNEDY\nL-1855  LUXEMBOURG",
        "address_parts": null,
        "checked_at": "2023-01-11T12:30:28.000000Z"
    },
    "registration_info_history": []
}
```

--------------------------------

### GET /v2/check

Source: https://vatcheckapi.com/docs/mcp.html

The check tool corresponds to the GET /v2/check endpoint, used to check a VAT number. The source does not document specific parameters or response schemas.

```APIDOC
## GET /v2/check

### Description
Check a VAT number.

### Method
GET

### Endpoint
/v2/check

### Parameters
No parameters are documented in the source.

### Response
No response schema is documented in the source.

### Error Handling
Tool calls are metered exactly like REST requests: they consume your plan quota and return the same status codes and error responses (401, 422, 429, ...). If a call fails, the tool result contains the API's error message including hints on how to proceed.
```

--------------------------------

### Authenticate with GET query parameter in BASH

Source: https://vatcheckapi.com/docs

Pass the API key as a query parameter named 'apikey' in a cURL request.

```BASH
curl "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY"
```

--------------------------------

### Status Endpoint Sample Response (JSON)

Source: https://vatcheckapi.com/docs/status.html

Example response from the status endpoint showing the account ID and quota details. The month quota shows total, used, and remaining requests; the grace quota shows similar fields.

```json
{
    "account_id": 313373133731337,
    "quotas": {
        "month": {
            "total": 300,
            "used": 71,
            "remaining": 229
        },
        "grace": {
            "total": 0,
            "used": 0,
            "remaining": 0
        }
    }
}
```

--------------------------------

### Authenticate with GET query parameter in PYTHON

Source: https://vatcheckapi.com/docs

Pass the API key as a query parameter named 'apikey' using the requests library.

```PYTHON
import requests
from requests.structures import CaseInsensitiveDict

url = "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY"

resp = requests.get(url)

print(resp.status_code)
```

--------------------------------

### Sample Response: JSON response for VAT validation

Source: https://vatcheckapi.com/docs/check.html

Example JSON response returned by the API. It includes country_code, vat_number, format_valid, checksum_valid, and registration_info fields.

```json
{
    "country_code": "LU",
    "vat_number": "26375245",
    "format_valid": true,
    "checksum_valid": true,
    "registration_info": {
        "is_registered": true,

```

--------------------------------

### GET /v2/status

Source: https://vatcheckapi.com/docs/mcp.html

The getStatus tool corresponds to the GET /v2/status endpoint, used to retrieve account quota status. The source does not document specific parameters or response schemas.

```APIDOC
## GET /v2/status

### Description
Get account quota status.

### Method
GET

### Endpoint
/v2/status

### Parameters
No parameters are documented in the source.

### Response
No response schema is documented in the source.

### Error Handling
Tool calls are metered exactly like REST requests: they consume your plan quota and return the same status codes and error responses (401, 422, 429, ...). If a call fails, the tool result contains the API's error message including hints on how to proceed.
```

--------------------------------

### Authenticate with GET query parameter in JAVASCRIPT

Source: https://vatcheckapi.com/docs

Pass the API key as a query parameter named 'apikey' using XMLHttpRequest.

```JAVASCRIPT
var oReq = new XMLHttpRequest();
oReq.addEventListener("load", function () { console.log(this.responseText); });
oReq.open("GET", "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY");
oReq.send();
```

--------------------------------

### Authenticate with GET query parameter in PHP

Source: https://vatcheckapi.com/docs

Pass the API key as a query parameter named 'apikey' using PHP cURL.

```PHP
$url = "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY";

$curl = curl_init($url);

$resp = curl_exec($curl);
var_dump($resp);
```

--------------------------------

### GET /v2/check

Source: https://vatcheckapi.com/docs

Check a VAT number using the vatcheckapi.com API. The endpoint requires an API key for authentication.

```APIDOC
## GET /v2/check

### Description
Check a VAT number using the vatcheckapi.com API. The endpoint requires an API key for authentication.

### Method
GET

### Endpoint
https://api.vatcheckapi.com/v2/check

### Parameters
#### Query Parameters
- **vat_number** (string) - Required - The VAT number to check.
- **apikey** (string) - Required - Your API key, passed as a query parameter.

### Request Example
```
curl "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY"
```

### Response
#### Success Response (200)
The response is not described in the source, but the endpoint returns a response that can be logged or printed.

#### Response Example
Not provided in the source.

```

--------------------------------

### GET https://api.vatcheckapi.com/v2/status

Source: https://vatcheckapi.com/docs/status.html

Returns your current quota. Requests to this endpoint do not count against your quota or rate limit.

```APIDOC
## [GET] https://api.vatcheckapi.com/v2/status

### Description
Returns your current quota. Requests to this endpoint do not count against your quota or rate limit.

### Method
GET

### Endpoint
https://api.vatcheckapi.com/v2/status

### Parameters
#### Header Parameters
- **apikey** (string) - Required - Your API Key

### Request Example
curl "https://api.vatcheckapi.com/v2/status" \
    -H "apikey: YOUR-APIKEY"

### Response
#### Success Response (200)
- **account_id** (integer) - The account identifier.
- **quotas** (object) - Contains quota details.
  - **month** (object) - Monthly quota details.
    - **total** (integer) - Total monthly quota.
    - **used** (integer) - Used quota.
    - **remaining** (integer) - Remaining quota.
  - **grace** (object) - Grace quota details.
    - **total** (integer) - Total grace quota.
    - **used** (integer) - Used grace quota.
    - **remaining** (integer) - Remaining grace quota.

#### Response Example
{
    "account_id": 313373133731337,
    "quotas": {
        "month": {
            "total": 300,
            "used": 71,
            "remaining": 229
        },
        "grace": {
            "total": 0,
            "used": 0,
            "remaining": 0
        }
    }
}
```

--------------------------------

### GET /v2/check

Source: https://vatcheckapi.com/docs/check.html

Validates a VAT number from any of the supported countries and returns its validity and company information.

```APIDOC
## GET /v2/check

### Description
Validates a VAT number from any of the supported countries and returns its validity and company information.

### Method
GET

### Endpoint
https://api.vatcheckapi.com/v2/check?vat_number=[[ vat_number ]]

### Parameters
#### Query Parameters
- **apikey** (string) - Required - Your API Key
- **vat_number** (string) - Required - The VAT number to check. Include the two-letter country prefix (e.g. `LU26375245`), or omit it and pass `country_code` separately
- **country_code** (string) - Optional - An ISO Alpha 2 Country Code for the VAT number (e.g. `LU`). Required if the `vat_number` has no country prefix

### Request Example
```bash
curl "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245" \
    -H "apikey: YOUR-APIKEY"
```

### Response
#### Success Response (200)
- **country_code** (string) - The country code of the VAT number
- **vat_number** (string) - The VAT number without the country prefix
- **format_valid** (boolean) - Whether the VAT number format is valid
- **checksum_valid** (boolean) - Whether the VAT number checksum is valid
- **registration_info** (object) - Contains registration details, including `is_registered` (boolean) indicating whether the VAT number is registered

#### Response Example
```json
{
    "country_code": "LU",
    "vat_number": "26375245",
    "format_valid": true,
    "checksum_valid": true,
    "registration_info": {
        "is_registered": true
    }
}
```
```

--------------------------------

### GET /v2/status

Source: https://vatcheckapi.com/docs/llms-full.txt

Returns the current quota for the authenticated account. Requests to this endpoint do not count against the quota or rate limit.

```APIDOC
## GET /v2/status

### Description
Returns the current quota for the authenticated account. Requests to this endpoint do not count against the quota or rate limit.

### Method
GET

### Endpoint
https://api.vatcheckapi.com/v2/status

### Parameters
#### Header Parameters
- **apikey** (string) - Required - Your API Key

### Request Example
curl "https://api.vatcheckapi.com/v2/status" \
    -H "apikey: YOUR-APIKEY"

### Response
#### Success Response (200)
- **account_id** (integer) - The account identifier.
- **quotas** (object) - Contains quota information for the month and grace buckets.
  - **month** (object) - Monthly quota details.
    - **total** (integer) - Total monthly quota.
    - **used** (integer) - Used quota.
    - **remaining** (integer) - Remaining quota.
  - **grace** (object) - Grace quota details.
    - **total** (integer) - Total grace quota.
    - **used** (integer) - Used grace quota.
    - **remaining** (integer) - Remaining grace quota.

#### Response Example
{
    "account_id": 313373133731337,
    "quotas": {
        "month": {
            "total": 300,
            "used": 71,
            "remaining": 229
        },
        "grace": {
            "total": 0,
            "used": 0,
            "remaining": 0
        }
    }
}
```

--------------------------------

### GET /v2/check with API key as query parameter

Source: https://vatcheckapi.com/docs/llms-full.txt

Authenticate a VAT check request by passing the API key as a query parameter named 'apikey'. This method is simple but may expose the key in logs.

```APIDOC
## [GET] /v2/check

### Description
Authenticate a VAT check request by passing the API key as a query parameter named `apikey`. This method is simple but may expose the key in logs.

### Method
GET

### Endpoint
https://api.vatcheckapi.com/v2/check

### Parameters
#### Query Parameters
- **vat_number** (string) - Required - The VAT number to check.
- **apikey** (string) - Required - Your API key.

### Request Example

curl "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY"


### Response
#### Success Response (200)
- **response** (object) - The response body contains the VAT check result.

#### Response Example

{
  "valid": true,
  "countryCode": "LU",
  "vatNumber": "26375245"
}

```

--------------------------------

### GET /v2/check with API key as HTTP header

Source: https://vatcheckapi.com/docs/llms-full.txt

Authenticate a VAT check request by setting the API key in the 'apikey' HTTP header. This method avoids exposing the key in query strings and logs.

```APIDOC
## [GET] /v2/check

### Description
Authenticate a VAT check request by setting the API key in the `apikey` HTTP header. This method avoids exposing the key in query strings and logs.

### Method
GET

### Endpoint
https://api.vatcheckapi.com/v2/check

### Parameters
#### Query Parameters
- **vat_number** (string) - Required - The VAT number to check.

#### Headers
- **apikey** (string) - Required - Your API key.

### Request Example

curl "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245" -H "apikey: YOUR-APIKEY"


### Response
#### Success Response (200)
- **response** (object) - The response body contains the VAT check result.

#### Response Example

{
  "valid": true,
  "countryCode": "LU",
  "vatNumber": "26375245"
}

```

--------------------------------

### Example 422 Error Response Body

Source: https://vatcheckapi.com/docs/status-codes

Shows the JSON structure of a 422 validation error response, including the message, errors object mapping invalid parameters to validation messages, and an info field with a deep link to the documentation.

```json
{
    "message": "Validation error",
    "errors": {
        "vat_number": [
            "The vat number field is required."
        ]
    },
    "info": "For more information, see documentation: https://vatcheckapi.com/docs/status-codes#_422"
}
```

--------------------------------

### Configure MCP-capable Client

Source: https://vatcheckapi.com/docs/mcp.html

JSON configuration format for adding the server to clients like Claude Desktop, Cursor, or VS Code.

```json
{
  "mcpServers": {
    "vatcheckapi": {
      "url": "https://api.vatcheckapi.com/mcp",
      "headers": { "apikey": "YOUR_API_KEY" }
    }
  }
}
```

--------------------------------

### Status Endpoint Sample Request (curl)

Source: https://vatcheckapi.com/docs/status.html

Use this request to check your current quota. The endpoint does not count against your quota or rate limit. Replace YOUR-APIKEY with your actual API key.

```bash
curl "https://api.vatcheckapi.com/v2/status" \
    -H "apikey: YOUR-APIKEY"
```

--------------------------------

### MCP Server Endpoint

Source: https://vatcheckapi.com/docs/mcp.html

The base URL for the hosted Model Context Protocol server.

```text
https://api.vatcheckapi.com/mcp
```

--------------------------------

### Authenticate with HTTP header in PYTHON

Source: https://vatcheckapi.com/docs

Pass the API key as an 'apikey' HTTP header using the requests library.

```PYTHON
import requests
from requests.structures import CaseInsensitiveDict

url = "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245"

headers = CaseInsensitiveDict()
headers["apikey"] = "YOUR-APIKEY"

resp = requests.get(url, headers=headers)

print(resp.status_code)
```

--------------------------------

### Authenticate with apikey query parameter

Source: https://vatcheckapi.com/docs/llms-full.txt

Pass the API key as a query parameter named `apikey` in the request URL. This method may expose the key in access logs; prefer the header method instead.

```bash
curl "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY"
```

```javascript
var oReq = new XMLHttpRequest();
oReq.addEventListener("load", function () { console.log(this.responseText); });
oReq.open("GET", "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY");
oReq.send();
```

```php
$url = "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY";

$curl = curl_init($url);

$resp = curl_exec($curl);
var_dump($resp);
```

```python
import requests
from requests.structures import CaseInsensitiveDict

url = "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245&apikey=YOUR-APIKEY"

resp = requests.get(url)

print(resp.status_code)
```

--------------------------------

### Connect via Claude Code

Source: https://vatcheckapi.com/docs/mcp.html

Command to add the vatcheckapi MCP server to Claude Code using the HTTP transport.

```bash
claude mcp add --transport http vatcheckapi https://api.vatcheckapi.com/mcp --header "apikey: YOUR_API_KEY"
```

--------------------------------

### Authenticate with HTTP header in PHP

Source: https://vatcheckapi.com/docs

Pass the API key as an 'apikey' HTTP header using PHP cURL.

```PHP
$url = "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245";

$curl = curl_init($url);

$headers = array(
   "apikey: YOUR-APIKEY",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$resp = curl_exec($curl);
var_dump($resp);
```

--------------------------------

### Authenticate with HTTP header in JAVASCRIPT

Source: https://vatcheckapi.com/docs

Pass the API key as an 'apikey' HTTP header using XMLHttpRequest.

```JAVASCRIPT
var oReq = new XMLHttpRequest();
oReq.addEventListener("load", function () { console.log(this.responseText); });
oReq.open("GET", "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245");
oReq.setRequestHeader("apikey", "YOUR-APIKEY");
oReq.send();
```

--------------------------------

### Authenticate with apikey HTTP header

Source: https://vatcheckapi.com/docs/llms-full.txt

Set the API key in the `apikey` request header instead of the URL. This avoids exposing the key in access logs.

```bash
curl "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245" \
    -H "apikey: YOUR-APIKEY" 
```

```javascript
var oReq = new XMLHttpRequest();
oReq.addEventListener("load", function () { console.log(this.responseText); });
oReq.open("GET", "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245");
oReq.setRequestHeader("apikey", "YOUR-APIKEY");
oReq.send();
```

```php
$url = "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245";

$curl = curl_init($url);

$headers = array(
   "apikey: YOUR-APIKEY",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$resp = curl_exec($curl);
var_dump($resp);
```

```python
import requests
from requests.structures import CaseInsensitiveDict

url = "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245"

headers = CaseInsensitiveDict()
headers["apikey"] = "YOUR-APIKEY"

resp = requests.get(url, headers=headers)

print(resp.status_code)
```

--------------------------------

### Rate limit response headers

Source: https://vatcheckapi.com/docs/llms-full.txt

Response headers returned by the API to indicate current monthly and minute quotas and remaining amounts. The monthly headers are attached on every plan; the minute headers are only sent on plans with a minute rate limit (e.g., the free plan).

```HTTP
X-RateLimit-Limit-Quota-Minute: 10
X-RateLimit-Limit-Quota-Month: 300

X-RateLimit-Remaining-Quota-Minute: 5
X-RateLimit-Remaining-Quota-Month: 199
```

--------------------------------

### Sample Request: curl command to validate VAT number

Source: https://vatcheckapi.com/docs/check.html

Use this curl command to validate a VAT number. Replace YOUR-APIKEY with your actual API key. The vat_number parameter includes the country prefix (e.g., LU26375245).

```bash
curl "https://api.vatcheckapi.com/v2/check?vat_number=LU26375245" \
    -H "apikey: YOUR-APIKEY"
```
Tokens:
Raw