# AgentStall ZA - South African Company Number Validator

> AgentStall ZA - South African Company Number Validator is a paid API for AI agents from agentstall.nilesh-b54.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-02).

Validates and formats a South African company registration number, returning its entity type and registration year

## Facts

- Endpoint: GET https://agentstall.nilesh-b54.workers.dev/v1/validate-company-number?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentstall-za-south-african-company-number-validator-3b9aacb4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CpOJ-bKbK-r09ziwSXun0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentstall-za-south-african-company-number-validator-3b9aacb4
```

Example prompt: Can you check whether 2015/123456/07 is a valid South African company registration number and tell me what type of entity it is?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "valid": true,
  "formatted": "2015/123456/07",
  "entityType": "Private company (Pty) Ltd",
  "registrationYear": 2015
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentstall-za-south-african-company-number-validator-3b9aacb4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentstall.nilesh-b54.workers.dev](https://www.zero.xyz/host/agentstall.nilesh-b54.workers.dev/llms.txt)