Vatstack

Vatstack Evidences API

The Evidences API from Vatstack — 2 operation(s) for evidences.

Documentation GitHub OpenAPI

Operations 4

POST /evidences Creates an evidence object #

GET /evidences Retrieves all evidence objects in order of creation, with the latest appearing… #

GET /evidences/{id} Retrieves an evidence object by the {id} path parameter #

PUT /evidences/{id} Updates an evidence object by the {id} path parameter #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/vatstack:vatstack-evidences-api"

All apis

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.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Vatstack API Specification Evidences 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: Evidences
paths:
  /evidences:
    post:
      operationId: createEvidence
      summary: Creates an evidence object
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                bank_address:
                  type: object
                  properties:
                    name:
                      type: string
                      description: Name of the bank or payment source used by the customer. This information is usually provided by your payments provider.
                    country_code:
                      type: string
                      description: 2-letter ISO country code of the bank or payment source. This information is usually provided by your payments provider.
                billing_address:
                  type: object
                  properties:
                    city:
                      type: string
                      description: City of the customer’s billing address.
                    country_code:
                      type: string
                      description: 2-letter ISO country code of the customer’s billing address.
                    line_1:
                      type: string
                      description: Line 1 of the customer’s billing address.
                    line_2:
                      type: string
                      description: Line 2 of the customer’s billing address.
                    postal_code:
                      type: string
                      description: Postal code of the customer’s billing address.
                    state:
                      type: string
                      description: State of the customer’s billing address.
                ip_address:
                  type: object
                  properties:
                    label:
                      type: string
                      description: IP address of the customer at the time of supply. We will automatically geolocate this IP address and hydrate the other fields.
        required: true
      responses:
        '201':
          description: Evidence object successfully created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/evidence'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - secretKey: []
      tags:
      - Evidences
    get:
      operationId: getAllEvidences
      summary: Retrieves all evidence objects in order of creation, with the latest appearing…
      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: Evidence 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
                  evidences_count:
                    type: integer
                    format: int32
                  evidences:
                    items:
                      $ref: '#/components/schemas/evidence'
                    type: array
                required:
                - has_more
                - evidences_count
                - evidences
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - secretKey: []
      tags:
      - Evidences
  /evidences/{id}:
    get:
      operationId: getEvidenceById
      summary: Retrieves an evidence object by the {id} path parameter
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Evidence object successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/evidence'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - secretKey: []
      tags:
      - Evidences
    put:
      operationId: updateEvidenceById
      summary: Updates an evidence object by the {id} path parameter
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                bank_address:
                  type: object
                  properties:
                    name:
                      type: string
                      description: Name of the bank or payment source used by the customer. This information is usually provided by your payments provider.
                    country_code:
                      type: string
                      description: 2-letter ISO country code of the bank or payment source. This information is usually provided by your payments provider.
                billing_address:
                  type: object
                  properties:
                    city:
                      type: string
                      description: City of the customer’s billing address.
                    country_code:
                      type: string
                      description: 2-letter ISO country code of the customer’s billing address.
                    line_1:
                      type: string
                      description: Line 1 of the customer’s billing address.
                    line_2:
                      type: string
                      description: Line 2 of the customer’s billing address.
                    postal_code:
                      type: string
                      description: Postal code of the customer’s billing address.
                    state:
                      type: string
                      description: State of the customer’s billing address.
                ip_address:
                  type: object
                  properties:
                    label:
                      type: string
                      description: IP address of the customer at the time of supply. We will automatically geolocate this IP address and hydrate the other fields.
        required: true
      responses:
        '200':
          description: Evidence object successfully updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/evidence'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
      security:
      - secretKey: []
      tags:
      - Evidences
components:
  schemas:
    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
    evidence:
      type: object
      description: Store pieces of evidence that confirm your customer’s location. Evidence object can be attached to a supply object and it can only be attached to one supply object at a time.
      properties:
        bank_address:
          type: object
          properties:
            country_code:
              type: string
              description: 2-letter ISO country code of the bank or payment source.
              maxLength: 2
              minLength: 2
            name:
              type: string
              description: Name of the bank or payment source.
        billing_address:
          type: object
          properties:
            city:
              type: string
              description: City of the customer’s billing address.
            country_code:
              type: string
              description: 2-letter ISO country code of the customer’s billing address.
              maxLength: 2
              minLength: 2
            line_1:
              type: string
              description: Line 1 of the customer’s billing address.
            line_2:
              type: string
              description: Line 2 of the customer’s billing address.
            postal_code:
              type: string
              description: Postal code of the customer’s billing address.
            state:
              type: string
              description: State of the customer’s billing address.
        created:
          type: string
          description: ISO date at which the object was created.
          format: date-time
        ip_address:
          type: object
          properties:
            label:
              type: string
              description: The same IP address coming from the `ip_address.label` body parameter which will be geolocated automatically.
            provider:
              type: string
              description: Provider used to geolocate `ip_address.label`. We use MaxMind® GeoIP2 geolocation technology by default but have a number of fallback providers.
            city:
              type: string
              description: City of the geolocated IP address.
            country_code:
              type: string
              description: 2-letter ISO country code of the geolocated IP address.
              maxLength: 2
              minLength: 2
            state:
              type: string
              description: State of the geolocated IP address.
        id:
          type: string
          description: Unique identifier for the object.
          format: uuid
        required_count:
          type: integer
          description: Required pieces of evidence according to your account’s regional settings.
          format: int32
        updated:
          type: string
          description: ISO date at which the object was updated.
          format: date-time
  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