HelpMyAgent Vat API

Vat

GitHub OpenAPI

Operations 1

POST /v1/vat/eu/validate EU VAT Validation #

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/helpmyagent-com:helpmyagent-com-vat-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.

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

OpenAPI Specification

helpmyagent-com-vat-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HelpMyAgent Vat API
  version: v1
  description: Pay-per-call APIs designed to be discovered and consumed by AI agents.
  x-guidance: HelpMyAgent exposes pay-per-call APIs. Choose an operation by its documented purpose, coverage and use_when guidance when available. Use the declared input schema and method. Each paid operation declares its decimal USD price in x-payment-info. An unpaid call returns HTTP 402 with x402 v2 payment requirements; submit a valid payment and retry the same request to receive the business JSON result. Do not use an endpoint outside its declared geographic coverage or documented use case.
  contact:
    url: https://helpmyagent.com
    email: hi@helpmyagent.com
servers:
- url: https://api.helpmyagent.com
  description: HelpMyAgent public API gateway
tags:
- name: vat
  description: Vat
paths:
  /v1/vat/eu/validate:
    post:
      tags:
      - vat
      summary: EU VAT Validation
      description: Validates an EU VAT number through the European Commission VIES service, with explicit unavailable status.
      operationId: v1VatEuValidate
      externalDocs:
        description: HelpMyAgent endpoint documentation
        url: https://helpmyagent.com/en/apis/vat/eu/validate
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  vat_number:
                    type: string
                    description: Structured value returned for “vat number” as defined by this API contract.
                  country_code:
                    type: string
                    description: Structured value returned for “country code” as defined by this API contract.
                  number:
                    type: string
                    description: Structured value returned for “number” as defined by this API contract.
                  status:
                    type: string
                    description: Normalized endpoint or source status.
                  valid:
                    type:
                    - boolean
                    - 'null'
                    description: Whether the supplied identifier passed the endpoint’s validation rules.
                  request_date:
                    type:
                    - string
                    - 'null'
                    description: Structured value returned for “request date” as defined by this API contract.
                  name:
                    type:
                    - string
                    - 'null'
                    description: Publicly available company, person, buyer or record name for this result.
                  address:
                    type:
                    - string
                    - 'null'
                    description: Structured value returned for “address” as defined by this API contract.
                  request_identifier:
                    type:
                    - string
                    - 'null'
                    description: Structured value returned for “request identifier” as defined by this API contract.
                  checked_at:
                    type: string
                    description: UTC timestamp at which HelpMyAgent performed the check.
                  source:
                    type: string
                    description: Structured value returned for “source” as defined by this API contract.
                additionalProperties: false
                required:
                - vat_number
                - country_code
                - number
                - status
                - valid
                - request_date
                - name
                - address
                - request_identifier
                - checked_at
                - source
                description: Structured result returned by the vat/eu/validate API.
              example:
                vat_number: FR39356000000
                country_code: FR
                number: '39356000000'
                status: unavailable
                valid: null
                request_date: null
                name: null
                address: null
                request_identifier: null
                checked_at: '2026-09-07T16:50:12+02:00'
                source: ec.europa.eu:vies
        '402':
          description: Payment required when payment is enabled for the endpoint.
        4XX:
          description: Client request error.
        5XX:
          description: Server or upstream provider error.
      x-helpmyagent-pricing:
        mode: fixed
        price: '0.005'
        currency: USD
        billingPolicy:
          charge_on: valid_result
          no_charge_on_empty_result: true
          no_charge_on_error: true
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
        accepts:
        - scheme: exact
          network: eip155:8453
          amount: '5000'
          asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          payTo: '0xEaB9543AcF710a24fe096913A428E7d066c88F59'
          maxTimeoutSeconds: 60
          extra:
            assetTransferMethod: eip3009
            name: USD Coin
            version: '2'
        - scheme: exact
          network: xrpl:0
          amount: '0.005'
          asset: 524C555344000000000000000000000000000000
          payTo: rUXKCZetEbwQc1i5vkJL6SNXYK3hG7Fezy
          maxTimeoutSeconds: 600
          extra:
            sourceTag: 804681468
            issuer: rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De
      x-helpmyagent-coverage:
        countries:
        - EU
      x-helpmyagent-use-when:
      - Validate an EU VAT number before invoicing or supplier onboarding.
      - You need to validate an EU VAT number through the European Commission VIES service before invoicing or onboarding.
      - You have either a complete VAT number or a country code plus national number.
      x-helpmyagent-avoid-when:
      - You need invoice-level consistency for a French company identifier; use company/fr/invoice-check.
      - You need broader supplier identity, compliance or IBAN checks; use company/fr/supplier-verification.
      x-helpmyagent-limitations:
      - Validation depends on VIES availability and on the member-state data returned through that service.
      - A valid VAT number does not prove bank-account ownership, solvency or absence of fraud.
      x-helpmyagent-example-queries:
      - Validate an EU VAT number before invoicing or supplier onboarding.
      x-helpmyagent-sources:
      - code: ec.europa.eu:vies
        name: European Commission VIES
        url: https://ec.europa.eu/taxation_customs/vies/
      x-helpmyagent-freshness:
        mode: source_dependent
      x-helpmyagent-mcp-annotations:
        readOnlyHint: false
        destructiveHint: false
        idempotentHint: false
        openWorldHint: false
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                vat_number:
                  type: string
                  pattern: ^(?:AT|BE|BG|CY|CZ|DE|DK|EE|EL|ES|FI|FR|GR|HR|HU|IE|IT|LT|LU|LV|MT|NL|PL|PT|RO|SE|SI|SK|XI)[A-Za-z0-9]{2,14}$
                  description: Complete EU VAT number including the two-letter country prefix; alternatively provide country_code and number separately.
                country_code:
                  type: string
                  enum:
                  - AT
                  - BE
                  - BG
                  - CY
                  - CZ
                  - DE
                  - DK
                  - EE
                  - EL
                  - ES
                  - FI
                  - FR
                  - GR
                  - HR
                  - HU
                  - IE
                  - IT
                  - LT
                  - LU
                  - LV
                  - MT
                  - NL
                  - PL
                  - PT
                  - RO
                  - SE
                  - SI
                  - SK
                  - XI
                  description: EU/VIES country prefix used when the VAT number is supplied in separate parts.
                number:
                  type: string
                  pattern: ^[A-Za-z0-9]{2,14}$
                  description: National VAT identifier body without the country prefix, used together with country_code.
              additionalProperties: false
              anyOf:
              - required:
                - vat_number
              - required:
                - country_code
                - number
              description: Structured input parameters for the vat/eu/validate API.
            example:
              vat_number: FR39356000000
      x-helpmyagent-demo:
        url: https://api.helpmyagent.com/demo/vat/eu/validate
        isSnapshot: true
        generatedAt: '2026-09-07T14:50:12+00:00'
        sourceAsOf: null
x-helpmyagent-discovery:
  llms: https://helpmyagent.com/llms.txt
  openapi: https://api.helpmyagent.com/openapi.json
  capabilities: https://helpmyagent.com/capabilities.json
  mcp: https://helpmyagent.com/mcp
  api_catalog: https://helpmyagent.com/.well-known/api-catalog
  pricing: https://helpmyagent.com/pricing.json
  x402: https://helpmyagent.com/.well-known/x402
  x402_service: https://helpmyagent.com/.well-known/x402-service.json
  health: https://helpmyagent.com/health