{"uid":"cap_ppwZs5Ie2J1A4WA7zYSJ_","slug":"veriffr-french-company-vat-lookup-api-bd703d6e","name":"VerifFR French Company & VAT Lookup API","description":"Verify French companies, EU VAT numbers, and addresses from one API. Pay per call with USDC on Base via x402. No account, no API key.","url":"https://veriffr.vercel.app/api/v1/company?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","required":[],"properties":{"q":{"type":"string","description":"Company name, SIREN (9 digits), SIRET (14 digits), or address fragment. Required if siret is not provided."},"limit":{"type":"integer","maximum":25,"minimum":1,"description":"Number of search results. Default 10. Ignored for exact SIRET lookups."},"siret":{"type":"string","description":"Exact 14-digit SIRET for a full company record. Overrides q."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"naf":"46.71Z","vat":"FR22531680445","city":"NANTERRE","name":"TOTALENERGIES MARKETING FRANCE","siren":"531680445","siret":"53168044500024","active":true,"address":"562 AVENUE DU PARC DE L'ILE 92000 NANTERRE","employees":"1000-1999 employees"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Y1qoPhAIu0ldjNP0GRTFs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up French company details (SIREN/SIRET), EU VAT numbers, and addresses by company name, identifier, or address fragment.","exampleAgentPrompt":"Can you look up TotalEnergies Marketing France and give me their SIRET, VAT number, and registered address? I want to confirm they're an active company before we sign a supplier contract.","exampleUseCases":[{"title":"Supplier due diligence before contract","prompt":"We're about to sign a contract with a French supplier called Legrand SA — can you pull their SIRET, VAT number, registered address, and confirm they're still an active business?"},{"title":"EU VAT number validation for invoicing","prompt":"I need to validate the EU VAT number for a French company before I issue an invoice — the company is called Vinci Construction, can you get their official VAT ID?"},{"title":"Enrich CRM with French company data","prompt":"I have a lead from a company named 'Capgemini' in France — can you find their SIRET, NAF code, employee count, and full registered address so I can enrich their CRM record?"}],"resultDescription":"Returns a JSON object with the company's official name, SIRET (14-digit), SIREN (9-digit), EU VAT number, full registered address, city, NAF activity code, active/inactive status, and employee band (e.g. '1000-1999 employees').","failureModes":["No match found for the given company name or identifier — returns empty results or 404","Ambiguous company name returns multiple results up to the limit; caller must refine query","Invalid or malformed SIRET (not 14 digits) causes a validation error","Rate limiting or payment failure on the x402 micropayment layer results in 402 response","Company exists but has no VAT number (e.g. micro-enterprises below VAT threshold) — VAT field may be null"],"whenToPreferThis":"Choose this endpoint when you need authoritative French company data (SIRET, SIREN, VAT, address) without needing an API key or monthly subscription — ideal for pay-per-call agent workflows doing one-off supplier verification, invoice validation, or CRM enrichment. Prefer it over full KYB platforms when you only need registry-level facts about French entities rather than full identity verification with documents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:32:44.437Z","isFirstParty":false,"canonicalSlug":"veriffr-french-company-vat-lookup-api-bd703d6e"}