<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Request Status Codes | vatcheckapi.com Documentation</title>
<meta name="generator" content="VuePress 1.9.10">
<link rel="icon" type="image/x-icon" href="https://app.vatcheckapi.com/img/favicon/vatcheckapi.ico">
<script src="/docs/scripts/scroll-to-hash.js"></script>
<script defer="defer" data-api="https://vatcheckapi.com/api/event" src="https://vatcheckapi.com/js/form.js"></script>
<meta name="description" content="">
<meta name="theme-color" content="#1d4ed8">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<link href="https://vatcheckapi.com/docs/status-codes" rel="canonical" />
<link rel="preload" href="/docs/assets/css/0.styles.3be896a9.css" as="style"><link rel="preload" href="/docs/assets/js/app.ae0e3421.js" as="script"><link rel="preload" href="/docs/assets/js/2.add04f6b.js" as="script"><link rel="preload" href="/docs/assets/js/1.48ef3dd2.js" as="script"><link rel="preload" href="/docs/assets/js/28.1d68d237.js" as="script"><link rel="prefetch" href="/docs/assets/js/10.6e999f12.js"><link rel="prefetch" href="/docs/assets/js/11.3ab4b135.js"><link rel="prefetch" href="/docs/assets/js/12.2458936c.js"><link rel="prefetch" href="/docs/assets/js/13.92f41f36.js"><link rel="prefetch" href="/docs/assets/js/14.58e150e1.js"><link rel="prefetch" href="/docs/assets/js/15.5fb152dd.js"><link rel="prefetch" href="/docs/assets/js/16.1f7ab0ca.js"><link rel="prefetch" href="/docs/assets/js/17.5e2a0646.js"><link rel="prefetch" href="/docs/assets/js/18.78c92286.js"><link rel="prefetch" href="/docs/assets/js/19.25290e0d.js"><link rel="prefetch" href="/docs/assets/js/20.8715daf5.js"><link rel="prefetch" href="/docs/assets/js/21.b49b9e26.js"><link rel="prefetch" href="/docs/assets/js/22.fdb25f7b.js"><link rel="prefetch" href="/docs/assets/js/23.923e2ca0.js"><link rel="prefetch" href="/docs/assets/js/24.38a15c81.js"><link rel="prefetch" href="/docs/assets/js/25.571883f2.js"><link rel="prefetch" href="/docs/assets/js/26.8bce3d46.js"><link rel="prefetch" href="/docs/assets/js/27.b885efab.js"><link rel="prefetch" href="/docs/assets/js/29.90e03052.js"><link rel="prefetch" href="/docs/assets/js/3.7ed6a7c9.js"><link rel="prefetch" href="/docs/assets/js/4.1650b8df.js"><link rel="prefetch" href="/docs/assets/js/5.ebf608a8.js"><link rel="prefetch" href="/docs/assets/js/6.3ff2d303.js"><link rel="prefetch" href="/docs/assets/js/7.f4d13fcd.js"><link rel="prefetch" href="/docs/assets/js/vendors~docsearch.2ce736d7.js">
<link rel="stylesheet" href="/docs/assets/css/0.styles.3be896a9.css">
</head>
<body>
<div id="app" data-server-rendered="true"><div class="theme-container"><header class="navbar"><div class="sidebar-button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <a href="/docs/" class="home-link router-link-active"><img src="https://app.vatcheckapi.com/img/logo/vatcheckapi.png" alt="vatcheckapi.com Documentation" class="logo"> <span class="site-name can-hide">vatcheckapi.com Documentation</span></a> <div class="links"><div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><a href="/docs/" class="nav-link">
Guide
</a></div> <!----></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><nav class="nav-links"><div class="nav-item"><a href="/docs/" class="nav-link">
Guide
</a></div> <!----></nav> <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading open"><span>Guide</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/docs/" aria-current="page" class="sidebar-link">Official libraries</a></li><li><a href="/docs/status-codes.html" class="active sidebar-link">Request Status Codes</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/docs/status-codes.html#api-error-codes" class="sidebar-link">API Error Codes</a></li><li class="sidebar-sub-header"><a href="/docs/status-codes.html#validation-errors" class="sidebar-link">Validation errors</a></li></ul></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><span>Endpoints</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/docs/status.html" class="sidebar-link">Status Endpoint</a></li><li><a href="/docs/check.html" class="sidebar-link">Validate Vat Number</a></li></ul></section></li></ul> </aside> <main class="page"> <div class="theme-default-content content__default"><h1 id="request-status-codes"><a href="#request-status-codes" class="header-anchor">#</a> Request Status Codes</h1> <p>For all requests, we will return an HTTP status code that indicates a success or the problem that has led to the failure.</p> <p>A successful request will be returned with status code <code>200</code></p> <h2 id="api-error-codes"><a href="#api-error-codes" class="header-anchor">#</a> API Error Codes</h2> <h3 id="_401"><a href="#_401" class="header-anchor">#</a> 401</h3> <p>Invalid authentication credentials</p> <h3 id="_403"><a href="#_403" class="header-anchor">#</a> 403</h3> <p>You are not allowed to use this endpoint, please <a href="https://app.vatcheckapi.com/subscription" target="_blank" rel="noopener noreferrer">upgrade your plan<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>.</p> <h3 id="_404"><a href="#_404" class="header-anchor">#</a> 404</h3> <p>A requested endpoint does not exist</p> <h3 id="_422"><a href="#_422" class="header-anchor">#</a> 422</h3> <p>Validation error, please check the list of validation errors: <a href="#validation-errors">here</a></p> <h3 id="_429"><a href="#_429" class="header-anchor">#</a> 429</h3> <p>You have hit your rate limit or your monthly limit. For more requests please <a href="https://app.vatcheckapi.com/subscription" target="_blank" rel="noopener noreferrer">upgrade your plan<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>.</p> <h3 id="_500"><a href="#_500" class="header-anchor">#</a> 500</h3> <p>Internal Server Error - let us know: support@vatcheckapi.com</p> <h3 id="_503"><a href="#_503" class="header-anchor">#</a> 503</h3> <p>The countries VAT validation service is currently not available.
You can retry the request at any point to check again.</p> <h2 id="validation-errors"><a href="#validation-errors" class="header-anchor">#</a> Validation errors</h2> <h4 id="missing-vat-number"><a href="#missing-vat-number" class="header-anchor">#</a> Missing vat_number</h4> <p>The <code>vat_number</code> parameter is required</p> <h4 id="missing-country-code"><a href="#missing-country-code" class="header-anchor">#</a> Missing country_code</h4> <p>The <code>country_code</code> parameter is required, if the given <code>vat_number</code> has no country code.</p></div> <footer class="page-edit"><!----> <!----></footer> <!----> </main></div><div class="global-ui"><!----></div></div>
<script src="/docs/assets/js/app.ae0e3421.js" defer></script><script src="/docs/assets/js/2.add04f6b.js" defer></script><script src="/docs/assets/js/1.48ef3dd2.js" defer></script><script src="/docs/assets/js/28.1d68d237.js" defer></script>
</body>
</html>