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.

KeyType
employer_namerequiredstring
employer_addressstring
employee_namerequiredstring
employee_idStaff, payroll or employee number.string
job_titlestring
pay_period_startdate
pay_period_enddate
pay_daterequireddate
currencyISO 4217 code, for example USD, EUR, or LKR.string
gross_paynumber
net_payrequiredTake-home pay for the period.number
tax_withheldnumber
other_deductions_totalTotal of non-tax deductions when a single total is shown.number
earningsEarnings lines for the period, in document order.object[]
└ descriptionrequiredstring
└ hoursnumber
└ ratenumber
└ amountrequirednumber
deductionsDeduction lines, in document order.object[]
└ descriptionrequiredstring
└ amountrequirednumber

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.

Output: values
{
  "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.

  1. Step 1

    Upload the document

    Drop a payslip into the Playground. PDF, PNG and JPEG all work, including scans and phone photos.

  2. 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.

  3. 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.