SSN structure validate API

Validates US SSN structure (rejects 000/666/900-999 area, 00 group, 0000 serial) and splits area/group/serial. Structure-only — makes no claim of actual issuance. Answers 'Is this SSN structurally valid?', 'What are its area/group/serial parts?'.

Price$0.02per request

MethodPOST

Route/v1/validate/ssn

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

ssnsocial-securityvalidatestructureusareagroupserialpii

API URLhttps://x402.hexl.dev/v1/validate/ssn

Integration docs

Example request

{
  "ssn": "123-45-6789"
}

Example response

{
  "valid": true,
  "reason": "Structurally valid SSN. Structure only — this does NOT claim the SSN was actually issued to a person.",
  "normalized": "123-45-6789",
  "area": "123",
  "group": "45",
  "serial": "6789"
}

Input schema

{
  "type": "object",
  "required": [
    "ssn"
  ],
  "properties": {
    "ssn": {
      "type": "string",
      "description": "9-digit SSN (AAA-GG-SSSS, hyphens optional).",
      "examples": [
        "123-45-6789"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}