The Quotes API from Vatstack — 2 operation(s) for quotes.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/vatstack:vatstack-quotes-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Vatstack API Specification Quotes API
description: A suite of VAT APIs which let you validate VAT numbers with government services, look up VAT rates by ISO country code, calculate price quotes with centralized VAT rules and store transactions with each sale for VAT reporting.
contact:
email: team@vatstack.com
version: 1.3.0
servers:
- url: https://api.vatstack.com/{basePath}
description: Production API server.
variables:
basePath:
default: v1
tags:
- name: Quotes
paths:
/quotes:
post:
operationId: createQuote
summary: Creates a quote object
requestBody:
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
amount:
type: integer
description: Amount in **cents** (e.g. 100.50 must be expressed as 10050). This common common workaround prevents unexpected rounding issues.
country_code:
type: string
description: 2-letter ISO country code. If provided, the `ip_address` parameter will be ignored.
category:
type: string
description: Digital products category used for calculation. Supports `audiobook`, `broadcasting`, `ebook`, `eperiodical`, `eservice` and `telecommunication`.
ip_address:
type: string
description: IP address to geolocate the VAT rate for. If neither IP address nor `country_code` is provided, it will be automatically determined from the request.
validation:
type: string
description: Unique identifier of a [validation object](https://vatstack.com/docs/validations). This is useful if you let your customer enter a VAT number beforehand. Its valid value can affect `vat.amount`, `vat.rate` and `amount_total` when zero-rating.
format: uuid
vat:
type: object
properties:
inclusive:
type: boolean
description: Boolean for whether the resulting VAT amount should be calculated inclusive or exclusive of VAT. Defaults to `false`. All other `vat` fields will be hydrated for you.
required:
- amount
required: true
responses:
'201':
description: Quote object successfully created.
content:
application/json:
schema:
$ref: '#/components/schemas/quote'
default:
description: Error response.
content:
application/json:
schema:
$ref: '#/components/schemas/error'
security:
- publicKey: []
secretKey: []
tags:
- Quotes
get:
operationId: getAllQuotes
summary: Retrieves all quote objects in order of creation, with the most recent…
parameters:
- name: limit
in: query
description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.
schema:
type: integer
format: int32
- name: page
in: query
description: Integer for the current page.
schema:
type: integer
format: int32
responses:
'200':
description: Quote objects successfully retrieved.
content:
application/json:
schema:
type: object
properties:
has_more:
description: True if this list has another page of items after this one that can be fetched.
type: boolean
quotes_count:
type: integer
format: int32
quotes:
items:
$ref: '#/components/schemas/quote'
type: array
required:
- has_more
- quotes_count
- quotes
default:
description: Error response.
content:
application/json:
schema:
$ref: '#/components/schemas/error'
security:
- secretKey: []
tags:
- Quotes
/quotes/{id}:
get:
operationId: getQuoteById
summary: Retrieves a quote object
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Quote object successfully retrieved.
content:
application/json:
schema:
$ref: '#/components/schemas/quote'
default:
description: Error response.
content:
application/json:
schema:
$ref: '#/components/schemas/error'
security:
- secretKey: []
tags:
- Quotes
components:
schemas:
validation:
type: object
description: Validate your business customer’s VAT number against official government servers in real-time. The API asynchronously validates VAT numbers for you if government services experience downtime.
properties:
active:
type: boolean
description: Boolean indicating whether the company exists and is active. Use `valid` to check whether the business is also VAT-registered.
default: null
code:
type: string
description: In the event of an error, this field will contain the error code.
company_address:
type: string
description: Address of the company the VAT number is associated with. Servers of Germany and Spain won’t return a value for privacy reasons and will default to `null`.
default: null
company_name:
type: string
description: Name of the company the VAT number is associated with. Servers of Germany and Spain won’t return a value for privacy reasons and will default to `null`.
default: null
company_type:
type: string
description: Type of the company entity returned by the respective government service (where available).
default: null
consultation_number:
type: string
description: If you save your own VAT number in your dashboard, the reply will contain a unique consultation number. The consultation number enables you to prove to a tax administration of a Member State that you have checked a VAT number at the `requested` date, and obtained a validation result.
default: null
country_code:
type: string
description: 2-letter ISO country code. Note that while Greek VAT numbers contain the `EL` country code, our response will return the ISO country code `GR`.
maxLength: 2
minLength: 2
created:
type: string
description: ISO date at which the object was created.
format: date-time
id:
type: string
description: Unique identifier for the object.
format: uuid
query:
type: string
description: Your original query.
requested:
type: string
description: ISO date at which the validation request was originally performed. Types `eu_vat` and `gb_vat` do not specify a time.
format: date-time
type:
type: string
description: Type of VAT number.
enum:
- au_gst
- ch_vat
- eu_oss_vat
- eu_vat
- gb_vat
- no_vat
- sg_gst
updated:
type: string
description: ISO date at which the object was updated.
format: date-time
valid:
type: boolean
description: Boolean indicating whether the vat_number is registered for VAT. If government services are down, the value will be `null` and re-checked automatically for you.
default: null
valid_format:
type: boolean
description: Boolean indicating whether the VAT number contained in `query` is in a valid format.
vat_number:
type: string
description: VAT number extracted from your query without the country code.
required:
- query
quote:
type: object
description: The quote object combines the best of the [rate object](https://vatstack.com/docs/rates) and [validation object](https://vatstack.com/docs/validations) and takes them a step further. It uses your existing business information to perform the entire VAT-compliant business logic for you. All VAT rules have been centralized so that every response is directly actionable.
properties:
amount:
type: integer
format: int32
amount_total:
type: integer
format: int32
category:
type: string
description: Category of the digital product. Defaults to `null` if no category was specified in the request or if the category cannot be applied for the `country_code`.
country_code:
type: string
description: 2-letter ISO country code.
maxLength: 2
minLength: 2
country_name:
type: string
description: Corresponding English name of `country_code`.
created:
type: string
description: ISO date at which the object was created.
format: date-time
id:
type: string
description: Unique identifier for the object.
format: uuid
ip_address:
type: string
description: The same IP address coming from the `ip_address` body parameter, or the geolocated IP address if none was provided. Value is `null` if `country_code` was provided.
local_name:
type: string
description: Localized name of the VAT identification number.
member_state:
type: boolean
description: Boolean indicating whether `country_code` is an EU member state.
updated:
type: string
description: ISO date at which the object was updated.
format: date-time
validation:
type: object
$ref: '#/components/schemas/validation'
vat:
type: object
properties:
abbreviation:
type: string
description: Abbreviation of `vat.local_name`.
amount:
type: integer
description: VAT amount in cents.
format: int32
inclusive:
type: string
description: Specifies if the `amount_total` is inclusive (common for EU consumers) or exclusive of VAT. This affects how the `vat.amount` is calculated. If `false`, you should present `amount` plus `vat.amount` to your customer as the final price to pay.
default: false
local_name:
type: string
description: Localized name of the VAT.
rate:
type: number
description: VAT rate applied for the calculation. If member_state is `false`, the value will be `0`.
format: double
rate_type:
type: string
description: Automatically determined type of VAT rate based on inputs. Can be `null`, `exempt`, `reduced`, `reverse_charge`, `standard` or `zero`.
error:
type: object
description: Error response from the Vatstack API.
properties:
code:
type: string
description: For validations, a short string indicating the [error code](https://vatstack.com/docs/validations).
maxLength: 50
message:
type: string
description: Human-readable message providing more details about the error.
maxLength: 250
securitySchemes:
publicKey:
type: apiKey
name: X-API-KEY
in: header
secretKey:
type: apiKey
name: X-API-KEY
in: header
externalDocs:
description: Vatstack API Reference
url: https://vatstack.com/docs