# OneShot Agent API – Company VAT Registration Lookup

> OneShot Agent API – Company VAT Registration Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Validates and retrieves company registration details for a given EU/Northern Ireland VAT number via the VIES system, returning name, address, and registration status.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/company-vat-registration?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-company-vat-registration-lookup-3de1f304
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k6zgLQB6u-XUJO1HAPPuy

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability oneshot-agent-api-company-vat-registration-lookup-3de1f304 -d '<json body>'
```

Example prompt: Can you check if VAT number 6388047V registered in Ireland (IE) is a valid EU company and tell me its registered name and address?

## When to prefer this

Use this endpoint when you need real-time, authoritative verification of an EU or Northern Ireland VAT number directly against the VIES database. Prefer it over manual lookups or third-party company databases when you specifically need to confirm VAT registration status for invoicing, compliance, or vendor onboarding workflows. It covers all 27 EU member states plus Northern Ireland (XI) at a very low per-call cost with no API key required.

## Known failure modes

- VAT number not found or not registered returns registered: false
- Invalid country code returns a validation error
- Malformed VAT number (wrong length or characters) returns a 400 error
- VIES system temporarily unavailable may cause timeouts or 5xx errors
- Leading country prefix in vat_number field is automatically stripped but double prefix may cause lookup failure

## How this service works

Check whether a VAT number is registered for cross-border trade in an EU member state or Northern Ireland.

## Output

Returns a JSON object with the company's registered name, registered address, country code, VAT number, a boolean indicating whether the number is currently registered/valid, and the timestamp of when the check was performed against VIES.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "enum": [
    "AT",
    "BE",
    "BG",
    "CY",
    "CZ",
    "DE",
    "DK",
    "EE",
    "EL",
    "ES",
    "FI",
    "FR",
    "HR",
    "HU",
    "IE",
    "IT",
    "LT",
    "LU",
    "LV",
    "MT",
    "NL",
    "PL",
    "PT",
    "RO",
    "SE",
    "SI",
    "SK",
    "XI"
   ],
   "type": "string",
   "description": "Two-letter code the source uses: the 27 EU member states (EL for Greece) or XI for Northern Ireland"
  },
  "vat_number": {
   "type": "string",
   "description": "The VAT number, 2 to 14 letters and digits once spaces, dots and dashes are removed; a leading country code equal to country is removed. 2 to 40 characters. letters, digits, spaces, dots and dashes only."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "GOOGLE IRELAND LIMITED",
  "address": "3RD FLOOR, GORDON HOUSE, BARROW STREET, DUBLIN 4",
  "country": "IE",
  "checked_at": "2026-10-13T14:24:09.159Z",
  "registered": true,
  "vat_number": "6388047V"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-company-vat-registration-lookup-3de1f304/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)