us_ssn_cardUS Social Security card
SSN structure, holder and work restriction legends.
- 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 the name, applies the SSN structure rules and detects restrictive legends such as "Valid for work only with DHS authorization".
- An SSN with a valid structure does not prove that it belongs to that person.
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 name
holder_name - Restriction
restriction - Signature present
signature_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 in test mode with the file us_ssn_card_specimen.jpg.
Sample response
Fictitious data. Shortened response.
{
"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 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: it is then kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it is 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 card required.