{"uid":"cap_CpOJ-bKbK-r09ziwSXun0","slug":"agentstall-za-south-african-company-number-validator-3b9aacb4","name":"AgentStall ZA - South African Company Number Validator","description":"South African company registration number check: validates a CIPC registration number (YYYY/NNNNNN/NN) and decodes the registration year and entity type, such as (Pty) Ltd, Ltd, NPC, Inc, CC, co-operative or SOC. Format check only, not a CIPC status lookup. Useful for supplier onboarding, invoices and tender paperwork.","url":"https://agentstall.nilesh-b54.workers.dev/v1/validate-company-number?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":["number"],"properties":{"number":{"type":"string","description":"Registration number, e.g. 2015/123456/07"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"valid":true,"formatted":"2015/123456/07","entityType":"Private company (Pty) Ltd","registrationYear":2015}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_scIx8BJ-0Tb6E7SQnbSG3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates and formats a South African company registration number, returning its entity type and registration year","exampleAgentPrompt":"Can you check whether 2015/123456/07 is a valid South African company registration number and tell me what type of entity it is?","exampleUseCases":[{"title":"Supplier onboarding compliance check","prompt":"Before we add this vendor to our system, can you verify that their company registration number 2019/345678/23 is a valid South African registration number and tell me what kind of entity they are?"},{"title":"Due diligence on a business partner","prompt":"I need to do a quick due diligence check — can you validate the South African company number 2012/089654/07 and confirm what type of entity it belongs to and when it was registered?"},{"title":"KYC data enrichment for a financial form","prompt":"I'm filling out a KYC form and need to confirm that the registration number the customer provided, 2008/004321/06, is correctly formatted and valid as a South African company number."}],"resultDescription":"Returns a JSON object with a boolean indicating whether the number is valid, the correctly formatted version of the registration number, the South African entity type (e.g. 'Private company (Pty) Ltd'), and the year of registration extracted from the number.","failureModes":["Invalid or malformed registration number returns valid: false with no entity type","Missing required 'number' query parameter returns a 400 or error response","Unpaid call returns HTTP 402 with PAYMENT-REQUIRED header requiring x402 USDC payment","Number with unrecognised format or suffix returns valid: false","Network or worker availability issues may return 5xx errors"],"whenToPreferThis":"Use this endpoint when you need to validate and classify a South African company registration number in the CIPC format (e.g. YYYY/NNNNNN/TT) and need to determine the legal entity type and registration year. Ideal for KYC workflows, supplier onboarding, due diligence checks, and form validation in South African business contexts. Prefer this over manual regex checks as it returns authoritative entity classification alongside format validation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T00:33:57.653Z","isFirstParty":false,"canonicalSlug":"agentstall-za-south-african-company-number-validator-3b9aacb4"}