{"uid":"cap_BJ35oNo7JkI_bDtYTA6WS","slug":"runonproof-uk-invoice-company-match-e53c145e","name":"RunOnProof UK Invoice Company Match","description":"Compare UK invoice identity fields with Companies House before payment. Use to detect company-name or registered-postcode mismatches. This does not prove invoice authenticity or VAT registration, and UNKNOWN fields remain explicit.","url":"https://cdo-production.up.railway.app/v1/gb/invoices/match-company","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"vat_number":{"type":"string","maxLength":20,"description":"Optional UK VAT number; this route does not independently verify VAT registration."},"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."},"invoice_address":{"type":"object","properties":{"line_1":{"type":"string","maxLength":300},"line_2":{"type":"string","maxLength":300},"country":{"type":"string","maxLength":80},"locality":{"type":"string","maxLength":200},"postal_code":{"type":"string","maxLength":20}},"additionalProperties":false},"invoice_company_name":{"type":"string","maxLength":300,"minLength":1,"description":"Legal name printed on the invoice."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JYLiAKM_xi-Dtqbwk3OJY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares UK invoice identity fields (company name, registered postcode) against Companies House records to detect mismatches before payment","exampleAgentPrompt":"Before we pay this invoice from Acme Logistics Ltd, company number 12345678, with a registered postcode of SW1A 1AA — can you cross-check those details against Companies House and flag any name or postcode mismatches?","exampleUseCases":[{"title":"Invoice fraud check before payment","prompt":"We just received an invoice from 'Bright Solutions Limited' with company number 09876543 and postcode EC1A 1BB — can you verify whether the company name and postcode match what's on Companies House before we approve the payment?"},{"title":"Onboarding new UK supplier","prompt":"We're about to onboard a new supplier called 'Northern Freight Services Ltd', company number OC334455, registered at postcode M1 2HX — can you check those details match Companies House before we add them to our vendor list?"},{"title":"Accounts payable mismatch investigation","prompt":"Our AP team flagged an invoice with company number 07654321 where the name printed is 'TechBridge UK Ltd' and the postcode shown is WC2N 5DU — can you run those against Companies House and tell me if there's any mismatch?"}],"resultDescription":"Returns a structured match result indicating whether the invoice company name and registered postcode align with Companies House records, with explicit UNKNOWN flags for fields that could not be verified. Does not confirm VAT registration or invoice authenticity.","failureModes":["Company number not found at Companies House — returns mismatch or unknown result","Invalid company number format — request rejected with validation error","Postcode not on record at Companies House — field returned as UNKNOWN","VAT number provided but not independently verified — noted in response","Missing required invoice_company_name — request rejected","Idempotency key conflict if reused with different payload"],"whenToPreferThis":"Use this endpoint when you have a UK supplier invoice and want to detect company-name or registered-postcode mismatches against the public Companies House registry before approving payment. Prefer this over full due-diligence endpoints when you only need lightweight identity-field matching rather than sanctions screening or full corporate graph analysis. It is not a substitute for VAT verification or proof of invoice authenticity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:42.533Z","isFirstParty":false}