us_ssn_card

US Social Security card

SSN structure, holder name and work restriction legend.

Category: Identity
Country: United States
Extracted fields: 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 storage "none": 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

Extracted fields

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

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 with a ck_test_ key and 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": "US 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: US 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 the document is authentic?

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

Is a copy of the document kept?

No, unless you ask for it. With storage "none" (the default) the file is deleted when the analysis ends.

And for the record…

Create your account, copy the test key and validate your first document in five minutes.

Create a free account Talk to sales