Payslip template
Extract payslip data from PDFs
Upload a payslip and get back employer and employee details, the pay period, gross and net pay and each earning and deduction line in a regular JSON shape.
Sign in to open the Playground with the Payslip template already picked. Or try a guest inbox from the home page with no account.
At a glance
- 21 keys, including earnings and deductions
- PDF, PNG and JPEG, including scans and photos
- Output: JSON, Excel (.xlsx), CSV
- Built to return null instead of guessing
- API and Playground documents are not stored after a request finishes
- Good for: payroll reconciliation, loan and mortgage applications, contractor payment records
Keys
What gets extracted
The Payslip template, exactly as it is saved in a new workspace. Every key comes back in the response. A value that is not on the document is null.
| Key | Type | Description |
|---|---|---|
| employer_namerequired | string | |
| employer_address | string | |
| employee_namerequired | string | |
| employee_idStaff, payroll or employee number. | string | Staff, payroll or employee number. |
| job_title | string | |
| pay_period_start | date | |
| pay_period_end | date | |
| pay_daterequired | date | |
| currencyISO 4217 code, for example USD, EUR, or LKR. | string | ISO 4217 code, for example USD, EUR, or LKR. |
| gross_pay | number | |
| net_payrequiredTake-home pay for the period. | number | Take-home pay for the period. |
| tax_withheld | number | |
| other_deductions_totalTotal of non-tax deductions when a single total is shown. | number | Total of non-tax deductions when a single total is shown. |
| earningsEarnings lines for the period, in document order. | object[] | Earnings lines for the period, in document order. |
| └ descriptionrequired | string | |
| └ hours | number | |
| └ rate | number | |
| └ amountrequired | number | |
| deductionsDeduction lines, in document order. | object[] | Deduction lines, in document order. |
| └ descriptionrequired | string | |
| └ amountrequired | number |
Good to know
Payslip: keys worth knowing
What the trickier keys in the Payslip template hold, and how they relate.
gross_pay and net_pay
Totals for the period as printed. net_pay is take-home pay after tax and other deductions.
earnings
Each pay line such as basic salary or allowances. hours and rate are filled when the slip shows them.
Example
From payslip to JSON
An illustrative payslip with a made-up company and numbers, and the JSON the Payslip template returns for it. Keys that are not on the document come back as null.
{
"employer_name": "Helio Analytics (Pvt) Ltd",
"employer_address": "42 Lake Road, Colombo 03",
"employee_name": "Maya Perera",
"employee_id": "EMP-1042",
"job_title": "Senior Software Engineer",
"pay_period_start": "2026-10-01",
"pay_period_end": "2026-10-31",
"pay_date": "2026-11-05",
"currency": "LKR",
"gross_pay": 485000,
"net_pay": 412300,
"tax_withheld": 52000,
"other_deductions_total": 20700,
"earnings": [
{
"description": "Basic salary",
"hours": null,
"rate": null,
"amount": 450000
},
{
"description": "Transport allowance",
"hours": null,
"rate": null,
"amount": 35000
}
],
"deductions": [
{
"description": "EPF employee",
"amount": 16200
},
{
"description": "Payee tax",
"amount": 52000
}
]
}Common gotchas
Where payslip extraction trips up
Things that often catch people out with payslip data, and how to handle them.
YTD versus current period
This template targets the current period amounts. Year-to-date columns are ignored unless you add keys for them in the layout editor.
Employer-specific labels
Deduction names vary by employer. Description is copied verbatim from the slip.
How it works
Three steps, no setup.
- Step 1
Upload the document
Drop a payslip into the Playground. PDF, PNG and JPEG all work, including scans and phone photos.
- Step 2
Pick the template
Choose the Payslip layout. It is already in every new workspace and guest browser, and you can edit its keys.
- Step 3
Review and export
The model fills exactly the layout's keys, with numbers as numbers and dates as yyyy-mm-dd. Copy the fields or download Excel or CSV.
Playground
Try the Payslip template now
Upload a payslip with the Payslip layout already picked. Edit the keys afterward if you need to match your own records.
FAQ
Payslip extraction, answered.
Can I download payslip data as Excel or CSV?
Yes. After a parse in the Playground, use Download to save the result as Excel (.xlsx) or CSV. Lists like line items get their own sheet in Excel and one row each in CSV.
Do you store my payslip documents?
No. The file is processed in memory for the request and then dropped. Neither the document nor the extracted JSON is saved. Only a usage record is kept, with things like the time, page count and credits used.
Can I change the keys?
Yes. Every new workspace, and every guest browser, starts with the Payslip template as a normal layout. Edit it, rename keys, add keys or delete it. Changes are yours, and a deleted template does not come back.
What happens when a value is not on the document?
It comes back as null. Doxtract is built to return null instead of guessing, so you can tell missing data from real data.
Is it free to try?
Yes. On the home page you can start a guest inbox with no account. Sign in for the Playground and a free plan with monthly credits and saved layouts. One credit is one page.
Try it on your own payslip.
Sign in to open the Playground with the Payslip template already picked, then drop in a file. A free account also unlocks saved layouts and exports at volume.