us_w2IRS Form W-2
Employer, EIN, wages and withholding from a W-2.
- Category
- Tax
- Country
- United States
- Fields it extracts
- 15 fields
- Cost
- 1 credit
us_w2specimen- Tax year
- Employer EIN
- Employer
- Employee SSN
- Employee name
- Employee address
- Wages, tips, other compensation
- Federal income tax withheld
- Social Security wages
Constaia extracts the tax year, the employer, the EIN and the box amounts, checks the EIN and SSN formats and compares the employee's name.
What it checks
- National identifiers. Official checksum or format of the number (NIF, CPF, CURP, RUT, SSN…).
us_ein, us_ssn - Holder. Name, number or date of birth match what you expect.
Fields it extracts
- Tax year
tax_year - Employer EIN
employer_ein - Employer
employer - Employee SSN
employee_ssn - Employee name
employee_name - Employee address
employee_address - Wages, tips, other compensation
wages - Federal income tax withheld
federal_income_tax_withheld - Social Security wages
social_security_wages - Social security tax withheld
social_security_tax_withheld - Medicare wages
medicare_wages - Medicare tax withheld
medicare_tax_withheld - State
state - State wages
state_wages - State income tax
state_income_tax
Sample request
curl https://api.constaia.com/v1/analyze \
-H "Authorization: Bearer $CONSTAIA_API_KEY" \
-F "file=@us_w2_specimen.pdf" \
-F 'options={
"expect": "us_w2",
"checks": {
"holder": {
"full_name": "Jordan Specimen"
},
"require_fields": [
"wages",
"tax_year"
]
},
"storage": "none"
}'Try it for free in test mode with the file us_w2_specimen.pdf.
Sample response
Fictitious data. Shortened response.
{
"id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
"object": "analysis",
"status": "completed",
"livemode": false,
"document": {
"type": "us_w2",
"label": "IRS Form W-2",
"confidence": 0.97
},
"verdict": {
"expected": [
"us_w2"
],
"match": true,
"status": "valid",
"reasons": [
{
"code": "type_match",
"severity": "info",
"message": "The document is: IRS Form W-2."
}
]
},
"fields": {
"tax_year": {
"value": 2025,
"confidence": 0.99,
"validated": true
},
"employee_name": {
"value": "JORDAN L SPECIMEN",
"confidence": 0.98,
"validated": null
},
"employee_ssn": {
"value": "XXX-XX-6789",
"confidence": 0.97,
"validated": null
},
"employer_name": {
"value": "EXAMPLE LOGISTICS INC",
"confidence": 0.96,
"validated": null
},
"employer_ein": {
"value": "12-3456789",
"confidence": 0.99,
"validated": null
},
"wages": {
"value": 58240.5,
"confidence": 0.98,
"validated": null
},
"federal_tax_withheld": {
"value": 6120,
"confidence": 0.97,
"validated": null
},
"state": {
"value": "IL",
"confidence": 0.96,
"validated": null
}
},
"checks": [
{
"code": "ein_format",
"passed": true,
"message": "The EIN has a valid format."
},
{
"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.