{"uid":"cap_NbKU8E9viWVxXrhCCdHXE","slug":"invoket-supplier-pre-flight-check-siren-lei-43295795","name":"Invoket Supplier Pre-flight Check (SIREN/LEI)","description":"The checks your agent runs before it acts: verify a bank account, a phone number, a law in force, the weather or a vehicle — computed from official sources, with provenance in every response. You only pay for answers.","url":"https://api.invoket.com/preflight/supplier","method":"GET","headers":{},"bodySchema":{"type":"object","required":["siren","screen_parent"],"properties":{"siren":{"type":"string","description":"9-digit SIREN (Luhn-checked). Give EXACTLY ONE entity key, 'siren' or 'lei' (20 characters); zero or two is a 400. Both keys pre-flight the same company: a 'lei' whose GLEIF record declares an existing SIREN reopens the French blocks (events, Peppol, derived VAT), stated in query.resolved_siren; a foreign entity gets them as 'not_applicable'. Optional: 'iban' adds the bank block, 'vat_number' replaces the derived one. A well-formed key unknown to the register is a 404, unbilled - no empty pre-flight is billed"},"screen_parent":{"type":"string","description":"Screen the ultimate parent against the sanctions lists too (default true). False makes that block 'not_requested', which does NOT block an 'ok': your explicit choice is not a coverage gap. Not knowing whether a parent exists is different - that is 'unavailable', and it does block 'ok'"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_t0pe8Wo2d0mFjXTrGuzwQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs compliance and identity pre-flight checks on a French or international company by SIREN or LEI number, including sanctions screening, IBAN validation, VAT derivation, and ultimate-parent screening, before an agent takes action.","exampleAgentPrompt":"Before we pay this French supplier, run a pre-flight check on them — their SIREN is 552081317, their IBAN is FR7630006000011234567890189, and please screen their ultimate parent against sanctions lists too.","exampleUseCases":[{"title":"Supplier onboarding sanctions screen","prompt":"I'm about to onboard a new French supplier with SIREN 410403891 — can you run a full compliance pre-flight on them including screening their parent company against sanctions lists before I sign the contract?"},{"title":"Pay-before-check IBAN validation","prompt":"We're about to wire €50,000 to a vendor. Their SIREN is 309302065 and their IBAN is FR7614508159847626816800160. Verify the company isn't sanctioned and confirm that IBAN checks out before I approve the payment."},{"title":"Foreign entity LEI compliance check","prompt":"This supplier gave us their LEI 969500T3MBS4SQAMHJ45 instead of a SIREN — run a pre-flight check on them, resolve any linked SIREN if there is one, and screen both them and their ultimate parent against sanctions lists."}],"resultDescription":"A structured JSON object containing a per-block compliance verdict for the company, including: sanctions screening result for the entity and optionally its ultimate parent, IBAN validity (if provided), derived or provided VAT number, Peppol network eligibility, SIREN/LEI resolution details (including resolved_siren for LEI inputs), and provenance metadata indicating official data sources used. An overall 'ok' or blocking status is provided. A 404 with no charge is returned for well-formed but unrecognized identifiers.","failureModes":["400 if both 'siren' and 'lei' are provided simultaneously, or neither is provided","404 if a syntactically valid SIREN/LEI is not found in the register (not billed)","400 if SIREN fails Luhn check or LEI is not 20 characters","'unavailable' status on parent block if parent existence cannot be determined, which blocks an overall 'ok'","Payment required (402) if x402 payment header is missing or insufficient"],"whenToPreferThis":"Use this endpoint when an AI agent needs to verify the compliance and identity of a French company (by SIREN) or any company with a LEI before taking a consequential action such as payment, contract signing, or supplier onboarding. It is the right choice when you need official-source provenance, sanctions screening including ultimate-parent screening, and optional IBAN and VAT validation bundled into a single pre-flight call. Prefer it over generic sanctions-list lookups or separate IBAN validators when dealing with European B2B payment workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:05.312Z","isFirstParty":false}