List payslips

Reading only. Nothing on this surface creates or changes a payslip.

Amounts carry their currency. A payslip that carries none — one built from a salary filed before the field was required — answers the company's own currency rather than null, so you do not have to invent that fallback yourself.

The line items are here: additions, deductions and allowances, each with its title, value and pre_tax, which is what decides whether an amount lands before tax is worked out.

loan_repaid is what was taken back against an advance. An advance is not a deduction: it becomes a loan and is repaid on scheduled days, so it never appears in deductions and a caller subtracting the line items from the total will be out by exactly this amount. The figure folds together loan repayments and one-off loan adjustments, because that is how the calculation records them.

The parts do not add up to take_home, and are not meant to. Taxes and the gross figure are not published here, so what you get is what was added, taken off and repaid — not a derivation of the total.

updated_since matters more here than anywhere: a payslip is recalculated and moves from draft to approved to paid, so without it a caller re-reads every month forever. months is YYYY-MM, and takes a list, so a quarter is one request.