# French Company Invoice Check API

> French Company Invoice Check API is a paid API for AI agents from api.helpmyagent.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-16).

Verifies a French company's existence and VAT number validity for invoice compliance checking

## Facts

- Endpoint: POST https://api.helpmyagent.com/v1/company/fr/invoice-check?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/french-company-invoice-check-api-ac402219
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JIecBjxRzI7o8TnlQEPS4

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 french-company-invoice-check-api-ac402219 -d '<json body>'
```

Example prompt: Can you check if the French company on this invoice is legitimate — their SIREN is 356000000 and the VAT number listed is FR39356000000? I want to make sure the company exists and the VAT number format matches before I approve the payment.

## When to prefer this

Use this endpoint when you need to verify a French company's registration and VAT number before processing an invoice, onboarding a vendor, or performing B2B compliance checks. It is specifically designed for French companies (SIREN-based identity) and cross-references public registry data with VIES VAT validation. Prefer this over generic company lookup APIs when you specifically need French tax compliance signals and VAT number format verification.

## Known failure modes

- Company not found in public registry — exists:false returned
- VIES service temporarily unavailable — vies_status:'unavailable', vies_valid:null
- Malformed SIREN or VAT number — format_match:false
- Invalid or missing required body fields — HTTP 400 or schema validation error
- Payment not processed — HTTP 402 if x402 payment header is missing or insufficient
- Rate limiting or service downtime — HTTP 429 or 503

## How this service works

Discover agent-ready APIs with REST, MCP, x402, transparent pricing, documented sources and real response examples.

## Output

Returns a JSON object with the company's official name, SIREN number, existence status, verdict (e.g. 'unverifiable'), expected and supplied VAT numbers, format match boolean, VIES validation status and name, timestamp of the check, and a list of limitations clarifying what the check does and does not validate (e.g. it does not validate a payment or bank account holder).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "LA POSTE",
  "siren": "356000000",
  "exists": true,
  "verdict": "unverifiable",
  "vies_name": null,
  "checked_at": "2026-09-07T16:50:11+02:00",
  "identifier": "356000000",
  "vies_valid": null,
  "limitations": [
   "Le contrôle rapproche des identifiants publics ; il ne valide ni une facture, ni un paiement, ni le titulaire d’un compte bancaire."
  ],
  "vies_status": "unavailable",
  "format_match": true,
  "expected_vat_number": "FR39356000000",
  "supplied_vat_number": "FR39356000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/french-company-invoice-check-api-ac402219/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.helpmyagent.com](https://www.zero.xyz/host/api.helpmyagent.com/llms.txt)
