{"uid":"cap_1OJw38fdc_zd3AUUQASU1","slug":"runonproof-uk-supplier-approval-cad3f9f7","name":"RunOnProof UK Supplier Approval","description":"Approve or hold a UK supplier before onboarding by combining Companies House identity/status with UK Sanctions List screening under a declared policy. Use for vendor onboarding; the decision is source-conditioned and never a universal approval.","url":"https://cdo-production.up.railway.app/v1/gb/solutions/supplier-approval","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_zOJ0K1NXbli8YsS0kVACZ","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":"Approve or hold a UK supplier for onboarding by combining Companies House identity/status verification with UK Sanctions List screening under a declared policy.","exampleAgentPrompt":"Can you run a supplier approval check on UK company number 12345678 under policy GB_NEW_SUPPLIER_V1, screening for sanctions, before we onboard them as a vendor? Use idempotency key supplier-onboard-12345678-001.","exampleUseCases":[{"title":"New vendor onboarding compliance check","prompt":"We want to onboard Acme Logistics Ltd as a supplier — their Companies House number is 09876543. Can you run them through our GB_NEW_SUPPLIER_V1 policy to check they're active and not on any UK sanctions list before we proceed?"},{"title":"Screening a supplier with known directors","prompt":"Before we sign a contract with this UK company (number 07654321), can you screen them and their directors — John Smith and Jane Doe — against the UK Sanctions List under policy GB_NEW_SUPPLIER_V1?"},{"title":"Validating an existing payee before payment","prompt":"We have payee fingerprint fp-abc123secure for company number 05432109 and want to confirm they still pass our GB_NEW_SUPPLIER_V1 supplier approval policy — including a fresh sanctions check — before releasing this payment."}],"resultDescription":"A policy-conditioned approval or hold decision for the UK supplier, incorporating real-time Companies House identity and status data alongside UK Sanctions List screening results. The response indicates whether the supplier is approved or held under the declared policy, with traceable evidence references.","failureModes":["Invalid Companies House company number format returns validation error","Company number not found in Companies House registry returns not-found error","Sanctions list service unavailable causes temporary failure","Expired or missing binding_evidence causes payee validation rejection","Idempotency key mismatch between body and header causes conflict error","Policy ID not recognised returns policy-not-found error","VAT or EORI number format invalid causes input rejection"],"whenToPreferThis":"Choose this endpoint when you need a single, policy-conditioned pass/hold decision for a UK supplier that combines Companies House identity verification with UK Sanctions List screening in one call. Prefer this over manual checks or separate Companies House and sanctions APIs when you need an auditable, source-conditioned onboarding decision tied to a declared policy (e.g. GB_NEW_SUPPLIER_V1). Not suitable for non-UK entities or general-purpose sanctions screening outside a supplier onboarding context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:45:42.251Z","isFirstParty":false}