# TBS Company SIREN/VAT/LEI API

> TBS Company SIREN/VAT/LEI API is a paid API for AI agents from x402.tbs-digital.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-10).

Looks up a company by SIREN, EU VAT, or LEI identifier and returns normalized legal name, status, address, activity code, officers, and data provenance in a single call.

## Facts

- Endpoint: GET https://x402.tbs-digital.com/company/lookup?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-company-siren-vat-lei-api-b2b6d9d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FfmZJxo-j49UNh1qSKd64

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 tbs-company-siren-vat-lei-api-b2b6d9d7
```

Example prompt: Can you look up the company with SIREN 552032534 and give me their legal name, current status, and registered address?

## When to prefer this

Choose this endpoint when you need a single, consistent company data schema regardless of whether the identifier is a French SIREN, an EU VAT number, or a global LEI — especially for e-invoicing, procurement onboarding, or compliance workflows where you don't want to manage separate API keys and integrations for Sirene, VIES, and GLEIF. It is ideal for agents that encounter mixed identifier types across their workflow and need one normalized response format with full provenance. Prefer alternatives if you need fuzzy name-based company search rather than exact-identifier lookup.

## Known failure modes

- Unknown or invalid identifier returns a not-found error with no record
- Malformed id_type enum value causes a validation error
- VIES service downtime may cause VAT lookups to fail with a upstream-unavailability error
- GLEIF API delays can slow LEI lookups beyond typical response time
- Company exists in registry but has incomplete data (e.g. no officers listed) — partial record returned
- Missing required query parameters (id or id_type) returns a 400 bad request

## How this service works

Unified company lookup by exact identifier: one call, one normalized schema across French SIREN (recherche-entreprises Sirene/RNE), EU VAT (VIES validation), and global LEI (GLEIF). Returns legal name, status, address, activity code, officers, and full provenance (source, retrieval time, license). No per-register API-key signup — pay once, get consistent company data for e-invoicing, procurement, and compliance. Input: id + id_type (siren | vat | lei).

## Output

A normalized JSON record containing the company's unique identifier and type, legal name, registration status (active/inactive/dissolved), registered country, full address, NACE/NAF activity code, list of officers, and a provenance block with source register name, retrieval timestamp, and data license. Also includes a top-level request ID and generation timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "id": {
       "type": "string",
       "description": "The identifier value"
      },
      "id_type": {
       "type": "string",
       "description": "siren | vat | lei"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "record": {
       "type": "object",
       "properties": {
        "id": {
         "type": "string"
        },
        "name": {
         "type": "string"
        },
        "status": {
         "type": "string"
        },
        "country": {
         "type": "string"
        },
        "id_type": {
         "type": "string"
        },
        "registration": {
         "type": "object"
        }
       }
      },
      "provenance": {
       "type": "object"
      },
      "request_id": {
       "type": "string"
      },
      "generated_at": {
       "type": "string",
       "format": "date-time"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tbs-company-siren-vat-lei-api-b2b6d9d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tbs-digital.com](https://www.zero.xyz/host/x402.tbs-digital.com/llms.txt)