W-2 Parser API
Extract structured data from w-2s with a single POST request. Built for tax preparers, lenders, and HR teams who want to automate, not click. JSON in, JSON out.
Quick start
cURL
curl -X POST https://parsew2.com/api/extract \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "file=@w2.pdf"
Python
import requests
resp = requests.post(
"https://parsew2.com/api/extract",
headers={"Authorization": "Bearer YOUR_API_KEY"},
files={"file": open("w2.pdf", "rb")},
)
print(resp.json()["data"]) # structured w-2 fieldsNode.js
const form = new FormData();
form.append("file", new Blob([fs.readFileSync("w2.pdf")]), "w2.pdf");
const res = await fetch("https://parsew2.com/api/extract", {
method: "POST",
headers: { Authorization: "Bearer YOUR_API_KEY" },
body: form,
});
const { data } = await res.json(); // structured w-2 fieldsFields returned
- ✓Wages, tips, other comp (Box 1)
- ✓Federal income tax withheld (Box 2)
- ✓Social Security wages & tax (Boxes 3-4)
- ✓Medicare wages & tax (Boxes 5-6)
- ✓State wages & tax (Boxes 15-17)
- ✓Employer EIN & name
Per-document pricing
No per-page billing. No enterprise minimums.
Confidence scores
Every field ships with a confidence value.
Batch & async
Submit many w-2s and poll for results.
FAQ
Is there a w-2 parsing API?
Yes. W-2 Parser exposes a REST endpoint — POST a w-2 file to /api/extract with your API key and receive structured JSON. No SDK required; it is a standard multipart upload.
How is the w-2 API priced?
By document, not per page. Free includes 3 w-2s; paid plans run from $9/mo (20 docs) to $199/mo (1,000 docs) with full API access on every tier. No per-page surprises and no enterprise minimums.
What does the API return?
A JSON object with the extracted fields (Wages, tips, other comp (Box 1), Federal income tax withheld (Box 2), Social Security wages & tax (Boxes 3-4), and more) plus a per-field confidence score. You can also request CSV/Excel exports.
How do I get an API key?
Sign up (free, no credit card), open your dashboard, and copy your key. You can start calling the API within a minute.
Can I process w-2s in batch?
Yes. Use the batch and async endpoints to submit many w-2s at once and poll for results — ideal for high-volume automation.