{"uid":"cap_YLt8-LmxRMi1MwLjfaugp","slug":"veriffr-french-address-autocomplete-api-9b45e820","name":"VerifFR French Address Autocomplete 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/address?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":["q"],"properties":{"q":{"type":"string","description":"French address fragment, at least 3 characters."},"limit":{"type":"integer","maximum":10,"minimum":1,"description":"Number of matches. Default 5."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"city":"Paris","label":"10 Rue de Rivoli 75004 Paris","score":0.97,"street":"Rue de Rivoli","latitude":48.8555,"postcode":"75004","longitude":2.36041,"housenumber":"10"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U1ifNPSULcGi_7j_5YlyA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Autocompletes and geocodes French address fragments, returning structured address components and coordinates","exampleAgentPrompt":"Can you look up the full address details for '10 Rue de Rivo' in Paris — I need the postcode, city, and coordinates, and show me the top 3 matches?","exampleUseCases":[{"title":"Address autocomplete in checkout form","prompt":"The user typed '15 rue de la paix par' into our address field — can you find the top 5 matching French addresses with their postcodes and GPS coordinates so I can show them suggestions?"},{"title":"Geocoding a French delivery location","prompt":"I need the latitude and longitude for '23 Avenue des Champs' in France — can you find the best matching full address and its coordinates?"},{"title":"Validating a French address before shipment","prompt":"Before we ship this order, can you verify that '8 Bd Haussmann 75009' is a real, properly formatted French address and give me the standardized label and postcode?"}],"resultDescription":"Returns a JSON object with the matched address label, street name, house number, city, postcode, latitude, longitude, and a confidence score (0–1). Up to the requested number of matches (default 5, max 10) are returned, ranked by relevance score.","failureModes":["Query string shorter than 3 characters returns an error or empty result","No matching addresses found returns an empty results array","Payment failure (insufficient USDC balance) blocks the request with a 402 response","Invalid or malformed query parameter returns a validation error","Network timeout from upstream address database"],"whenToPreferThis":"Choose this endpoint when you need to autocomplete, geocode, or validate French addresses specifically, and want a pay-per-call model with no account or API key setup. It is ideal for AI agents needing lightweight, on-demand French address resolution without committing to a subscription. Prefer it over general geocoding APIs when you only need France coverage and want USDC micropayment billing on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:30:15.164Z","isFirstParty":false,"canonicalSlug":"veriffr-french-address-autocomplete-api-9b45e820"}