{"uid":"cap_N5gsqpyVVkmbUhCuIcakn","slug":"agentstall-za-south-african-id-number-validator-e345a3c4","name":"AgentStall ZA – South African ID Number Validator","description":"South African ID number validation: checks a 13-digit SA ID number (date of birth, citizenship digit and Luhn checksum) and decodes date of birth, age, gender and citizenship status. Structural check only, with no Home Affairs lookup; the number is not stored. Useful for KYC and onboarding forms and for catching typos.","url":"https://agentstall.nilesh-b54.workers.dev/v1/validate-id?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":["id"],"properties":{"id":{"type":"string","description":"13-digit SA ID number"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"valid":true,"decoded":{"gender":"male","ageYears":46,"citizenship":"SA citizen","dateOfBirth":"1980-01-01"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sY_sIn2h3Qh36q6v7Mv29","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a 13-digit South African ID number and decodes embedded demographic data including gender, date of birth, age, and citizenship status","exampleAgentPrompt":"Can you check whether the South African ID number 8001015009087 is valid, and tell me what gender, date of birth, and citizenship status it encodes?","exampleUseCases":[{"title":"KYC onboarding ID check","prompt":"I need to verify this customer's South African ID number 9202204720082 before completing their onboarding — is it valid and what does it say about their gender and age?"},{"title":"Age eligibility verification","prompt":"Check if the SA ID 0001014800086 is a valid ID number and confirm whether the person is over 18 years old based on the encoded date of birth."},{"title":"Citizenship status confirmation","prompt":"Can you validate the South African ID 7810125012082 and tell me whether the holder is a SA citizen or a permanent resident?"}],"resultDescription":"A JSON object with a 'valid' boolean indicating whether the ID number passes the Luhn check and structural validation, plus a 'decoded' object containing gender (male/female), dateOfBirth (YYYY-MM-DD), ageYears (integer), and citizenship ('SA citizen' or 'permanent resident') if valid.","failureModes":["ID number fewer or greater than 13 digits returns validation failure or error","Invalid Luhn checksum returns valid:false with no decoded block","Missing 'id' query parameter returns 402 or 400 error","Unpaid call (no x402 payment header) returns HTTP 402 with PAYMENT-REQUIRED header","Non-numeric characters in ID string may cause parse error"],"whenToPreferThis":"Use this endpoint when you need to validate and decode a South African 13-digit ID number specifically — it applies the SA government's Luhn algorithm and parses the embedded date-of-birth, gender, and citizenship fields. Prefer it over generic checksum validators because it returns decoded semantic fields meaningful for KYC, compliance, and eligibility checks in a South African context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T00:35:45.538Z","isFirstParty":false,"canonicalSlug":"agentstall-za-south-african-id-number-validator-e345a3c4"}