{"uid":"cap_QtYNG6_6mjl4T-OzU-M0s","slug":"runonproof-uk-supplier-approval-4e705c75","name":"RunOnProof UK Supplier Approval","description":"Screen a UK supplier before onboarding using Companies House status and the UK Sanctions List under the declared policy. Use for a bounded vendor decision. APPROVE is policy- and source-scoped, never a universal compliance approval.","url":"https://cdo-production.up.railway.app/v1/gb/suppliers/approve","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"payee":{"type":"object","required":["company_number","payee_fingerprint"],"properties":{"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"binding_evidence":{"type":"object","required":["type","verified_at","valid_until","reference"],"properties":{"type":{"enum":["PREVIOUSLY_VERIFIED_BINDING","BANK_PROVIDER_CONFIRMATION","CUSTOMER_CONFIRMATION","CHALLENGE"]},"reference":{"type":"string","maxLength":200,"minLength":1,"description":"Non-secret reference to the evidence held by the caller."},"valid_until":{"type":"string","format":"date-time","description":"Expiry of the caller/provider evidence; must be in the future."},"verified_at":{"type":"string","format":"date-time","description":"When the caller or provider verified the binding."}},"additionalProperties":false},"payee_fingerprint":{"type":"string","maxLength":200,"minLength":8,"description":"Opaque caller-generated fingerprint; never send raw bank-account details."}},"additionalProperties":false},"policy_id":{"type":"string","maxLength":120,"minLength":3,"description":"Declared onboarding policy, normally GB_NEW_SUPPLIER_V1."},"vat_number":{"type":"string","maxLength":20},"eori_number":{"type":"string","maxLength":30},"company_number":{"type":"string","pattern":"^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$","description":"Companies House company number, including any two-letter prefix when applicable."},"idempotency_key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,120}$","description":"Caller-generated key. Send the identical value in the Idempotency-Key header."},"sanctions_subject_names":{"type":"array","items":{"type":"string","maxLength":300,"minLength":3},"maxItems":25,"uniqueItems":true}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4rIMMaB8DqGYrcCAPk6Lv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens a UK supplier against Companies House status and the UK Sanctions List under a declared onboarding policy, returning a bounded APPROVE or HOLD decision.","exampleAgentPrompt":"Can you screen UK company number 12345678 against Companies House and the UK Sanctions List under policy GB_NEW_SUPPLIER_V1 before we onboard them as a supplier? Their payee fingerprint is 'supp-fp-abc123xyz'.","exampleUseCases":[{"title":"New vendor onboarding compliance check","prompt":"We want to onboard a new UK supplier with Companies House number 09876543. Can you run them through our standard GB_NEW_SUPPLIER_V1 onboarding policy — check their Companies House status and screen them against the UK Sanctions List — before we add them to our approved vendor list? Use payee fingerprint 'vendor-fp-98765abc'."},{"title":"Sanctions screening before first contract","prompt":"Before we sign a contract with a UK company (company number SC123456), can you check whether they appear on the UK Sanctions List and confirm their Companies House status is active? Use policy GB_NEW_SUPPLIER_V1 and payee fingerprint 'contract-fp-sc123456x'. Their VAT number is GB123456789."},{"title":"Automated supplier approval in procurement workflow","prompt":"As part of our procurement workflow, please approve or hold UK supplier 00445790 under policy GB_NEW_SUPPLIER_V1 — check their Companies House standing and sanctions exposure. Payee fingerprint is 'proc-fp-00445790z'. Flag any sanctions subject names including 'Acme Trading Ltd'."}],"resultDescription":"Returns a bounded APPROVE or HOLD decision for the UK supplier, scoped to the declared policy and the two data sources checked (Companies House and UK Sanctions List). Includes the Companies House status, sanctions match outcome, and a traceable decision reference. The APPROVE result is policy-scoped and source-scoped, not a universal compliance clearance.","failureModes":["Invalid Companies House company number format — returns validation error","Company not found in Companies House registry — decision cannot be made","Sanctions list service unavailable — request fails or returns error","Payee fingerprint missing or too short — schema validation error","Policy ID not recognized — returns policy error","Idempotency key format mismatch — request rejected","binding_evidence.valid_until is in the past — validation failure","Sanctions subject names list exceeds 25 items — schema error"],"whenToPreferThis":"Use this endpoint when you need a fast, policy-scoped pre-onboarding decision for a UK supplier combining Companies House identity/status verification with UK Sanctions List screening in a single call. Prefer this over manual checks or generic company lookup endpoints when you need a traceable, policy-bound APPROVE/HOLD verdict suitable for audit trails. Do not use for non-UK companies, payment authorization (use the payment authorization endpoint), or when you need a universal compliance certification rather than a bounded policy decision.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:32:02.833Z","isFirstParty":false}