Skip to content
Constaia
us_ssn_card

Social Security card

SSN structure, holder name and work restriction legend.

Category
Identity
Country
United States
Fields it extracts
4 fields
Cost
1 credit
us_ssn_cardspecimen
Social Security number (SSN)
Holder name
Restriction
Signature present

Constaia reads the Social Security number and name, applies the SSN structure rules and detects restrictive legends such as "Valid for work only with DHS authorization". A card without such a legend is a List C document for Form I-9.

  • A structurally valid SSN does not prove it belongs to that person. For that, use the Social Security Administration's own services or E-Verify where applicable.
  • Request the card only when a rule requires it, and prefer not to keep the file: an SSN is highly sensitive data.

What it checks

  • National identifiers. Official checksum or format of the number (NIF, CPF, CURP, RUT, SSN…).us_ssn
  • Holder. Name, number or date of birth match what you expect.
  • Form I-9. Whether the document belongs to list A, B or C.C

Fields it extracts

  • Social Security number (SSN)ssn
  • Holder nameholder_name
  • Restrictionrestriction
  • Signature presentsignature_present

Where it is used

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_ssn_card_specimen.jpg" \
  -F 'options={
    "expect": "us_ssn_card",
    "checks": {
      "holder": {
        "full_name": "Jordan Specimen"
      }
    },
    "storage": "none"
  }'

Try it for free in test mode with the file us_ssn_card_specimen.jpg.

Sample response

Fictitious data. Shortened response.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_ssn_card",
    "label": "Social Security card",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_ssn_card"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: Social Security card."
      }
    ]
  },
  "fields": {
    "ssn": {
      "value": "123-45-6789",
      "confidence": 0.99,
      "validated": true
    },
    "holder_name": {
      "value": "JORDAN LEE SPECIMEN",
      "confidence": 0.98,
      "validated": null
    },
    "work_restriction_legend": {
      "value": null,
      "confidence": 0.97,
      "validated": null
    },
    "signature_present": {
      "value": true,
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "ssn_format",
      "passed": true,
      "message": "The SSN has a valid structure."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "The holder matches."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

Does Constaia prove that the document is authentic?

No. It checks the type, the consistency of the data and your rules, and flags signals such as a possible edit or a photo of a screen. That does not prove authenticity.

Is a copy of the document kept?

Only if it needs review: then it's kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it's deleted as soon as the analysis ends. You can choose never to keep it.

Other documents

And for the record…

Create your free account and validate your first document in five minutes. No credit card required.