# Request Status Codes

For all requests, we will return an HTTP status code that indicates a success or the problem that has led to the failure.

A successful request will be returned with status code 200

# Error Response Body

Error responses are JSON objects with the following fields:

Field	Presence	Description
`message`	always	A human-readable description of the error
`errors`	422 only	An object mapping each invalid parameter to an array of validation messages
`info`	422 only	A sentence containing a deep link to the matching section of this page, e.g. `For more information, see documentation: https://vatcheckapi.com/docs/status-codes#_422`. Sent alongside `errors` on `422` responses raised by request validation (e.g. a missing `vat_number`); other errors omit it
`error`	401, 403, 404, 429	An object with a stable machine-readable `code` (e.g. `invalid_api_key`, `quota_exceeded`) and the same human-readable `message`
`actions`	401, 403, 404, 429	An object of suggested next steps as URLs, e.g. `upgrade` and `docs`
`quota`	quota `429` only	The current quota state: `limit`, `used`, `remaining` and `resets_at`

{
    "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"
}

# API Error Codes

# 401

Invalid authentication credentials

# 403

You are not allowed to use this endpoint, please upgrade your plan (opens new window).

# 404

A requested endpoint does not exist

# 422

Validation error, please check the list of validation errors: here

# 429

You have hit your rate limit or your monthly limit. For more requests please upgrade your plan (opens new window).

# 500

Internal Server Error - let us know: support@vatcheckapi.com

# 503

The countries VAT validation service is currently not available. You can retry the request at any point to check again.

# Validation errors

# Missing vat_number

The vat_number parameter is required

# Missing country_code

The country_code parameter is required, if the given vat_number has no country code.

# Unsupported country_code

The given country_code (or the country prefix of the vat_number) is not one of the supported countries (opens new window).

# Invalid VAT number

The given vat_number could not be validated. Unlike the parameter errors above, this response contains only a message ("Invalid VAT number.") and no errors object.