Get a payslip
accounting:payrolls.readhttps://api.holded.com/api/v2/payslips/{payslipId}Returns a single payslip with the breakdown the payroll engine computed for it: earning lines, deductions, employer contributions, the contribution bases and the net the employee receives. A payslip (Spanish *nómina*) is NOT a salary record (*registro salarial*), which is served by `/api/v2/salary-records`. Ids of both look identical, so asking this endpoint for a salary-record id returns 404 naming the resource that does serve it. Money and rates are decimal strings. Percentages are expressed as the number, so "12.50" means 12.5%.
Parameters
Path parameters
stringrequiredPayslip ID (24-character hexadecimal ObjectId)
Request
import requests
url = "https://api.holded.com/api/v2/payslips/507f1f77bcf86cd799439011"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Responses
Response
{
"id": "507f1f77bcf86cd799439011",
"employee_id": "507f1f77bcf86cd799439012",
"employee_name": "Jane Doe",
"payslip_kind": "nomina_ordinaria",
"date": "2024-03-31",
"period_start": "2024-03-01",
"period_end": "2024-03-31",
"total_days": 30,
"description": "March 2024",
"tags": [
"office-madrid"
],
"accounting_account_id": "507f1f77bcf86cd799439013",
"is_draft": false,
"net_salary": "1663.00",
"total_company_cost": "2640.00",
"payment_total": "1663.00",
"payment_pending": "0.00",
"payment_status": "PENDING",
"is_ex_employee": false,
"irpf_rate": "12.50",
"extra_payments_prorata": "0.00",
"bases": [
{
"concept": "cotizacion_contingencias_comunes",
"amount": "2000.00"
}
],
"earnings": [
{
"name": "Salario base",
"payroll_item_id": "earning.salario_base",
"units": "30.00",
"price": "50.00",
"amount": "1500.00",
"bases": [
"cotizacion_contingencias_comunes"
],
"is_remuneration": true,
"is_paid_by_company": true
}
],
"deductions": [
{
"type": "contribution",
"concept": "contingencias_comunes",
"payroll_item_id": "deduction.anticipo_semanal",
"name": "Anticipo",
"units": "string",
"price": "string",
"percentage": "4.70",
"amount": "94.00"
}
],
"company_contributions": [
{
"concept": "contingencias_comunes",
"name": "Contingencias comunes",
"base": "2000.00",
"percentage": "23.60",
"amount": "472.00"
}
],
"payments": [
{
"id": "507f1f77bcf86cd799439011",
"amount": "1450.00",
"date": "2026-02-01",
"bank_account_id": "507f1f77bcf86cd799439012"
}
]
}Success responses
200Payslip foundapplication/jsonUnique identifier of the payslip
Identifier of the employee this payslip belongs to. Null when the employee has been deleted.
Snapshot of the employee's full name at the time the payslip was created
Kind of payslip: `nomina_ordinaria` (ordinary monthly payslip), `gratificacion_no_cuantificable` (non-quantifiable bonus regularisation) or `finiquito` (final settlement).
nomina_ordinariagratificacion_no_cuantificablefiniquitoatrasosAccrual date of the payslip (ISO 8601)
First day of the liquidation period covered by the payslip. Null on payslips created before periods were stored.
Last day of the liquidation period covered by the payslip. Null on payslips created before periods were stored.
Days paid in the liquidation period
Free-form description of the payslip
List of tags attached to the payslip
Accounting account where the payroll expense is posted
Whether the payslip is still a draft. A draft has not been approved and is not posted to the ledger.
Amount the employee receives (salario neto), as a decimal string. Equals the sum of `earnings` minus the sum of `deductions`.
Total cost for the company (gross salary plus employer contributions), as a decimal string.
Total amount already paid, as a decimal string
Amount still pending payment, as a decimal string
Payment status of the payslip
PENDINGPAIDPARTIALLY_PAIDWhether the employee has since left the company
Income tax rate applied, as a decimal string percentage (e.g. "12.50" means 12.5%)
Share of the extra payments (pagas extra) accrued in this period, as a decimal string
Contribution and tax bases the payslip was computed on, one row per base. On a bonus regularisation (`gratificacion_no_cuantificable`) they come from the bases the employee has accumulated over the year, not from the lines in this payslip, so a line can feed one base while another still carries an amount.
Base identifier, the same values used by `earnings[].bases`
cotizacion_contingencias_comunescotizacion_at_eptributacion_irpfBase amount, as a decimal string
Earning lines (percepciones). `amount` is the line total; `units` and `price` are only set on lines computed from a quantity.
Concept name as stored on the payslip
Opaque identifier of the payroll concept: treat it as a string and do not parse it. Concepts from the Holded catalogue use a `<type>.<id>` key such as `earning.salario_base`, and concepts an account creates are usually 24-character ObjectIds, but neither shape is guaranteed and neither tells you which of the two it is.
Units the line is computed from, as a decimal string
Amount per unit, as a decimal string
Line total, as a decimal string
Contribution and tax bases this line feeds
Whether the line is remuneration (percepción salarial)
Whether the company pays this line, as opposed to social security
Deduction lines. Every `amount` is a positive magnitude to subtract, so `net_salary` equals the sum of `earnings` minus the sum of this array. `type` tells them apart: `discount` is a deduction entered on the payslip, `contribution` is an employee social-security contribution and `retention` is the income tax withheld. On a bonus regularisation (`gratificacion_no_cuantificable`) an amount is the difference against what the employee already contributed over the year, so it may not equal `base` times `percentage`.
Deduction family
discountcontributionretentionStable concept key. Set on `contribution` and `retention` lines, null on `discount` lines, which carry `payroll_item_id` instead.
Opaque identifier of the payroll concept, set on `discount` lines: treat it as a string and do not parse it. It may be a `<type>.<id>` catalogue key or a 24-character ObjectId, and the shape is not part of the contract.
Human-readable concept name in the account language. Null when the concept has no label available.
Units the line is computed from, as a decimal string
Amount per unit, as a decimal string
Rate applied, as a decimal string percentage. Null when the domain exposes no rate for the concept.
Deducted amount as a positive decimal string
Employer social-security contributions, one row per concept. Every row carries its own amount, so the array sums with no double counting.
Stable contribution concept key
contingencias_comunesmeiaccidentes_de_trabajo_y_enfermedad_profesionaldesempleofogasaformacion_profesionalcotizacion_solidaridadHuman-readable concept name in the account language. Null when the concept has no label available.
Base the contribution is computed on, as a decimal string
Rate applied, as a decimal string percentage. Null when the domain exposes no rate for the concept.
Contribution amount, as a decimal string
Payments registered against this payslip. Empty when nothing has been paid yet. `id` is the only place a payment id is exposed, and it is what `DELETE /api/v2/payslips/{payslipId}/payments/{paymentId}` takes. The order of this array is not part of the contract: identify a payment by its `amount` and `date`, never by its position.
Payment identifier (24-character hexadecimal ObjectId)
Amount paid, as a decimal string
Payment date
Treasury account the payment is tied to. Null when the payment was registered without one.
Error responses
401Invalid or missing API keyapplication/json403Insufficient permissionsapplication/json404Payslip not foundapplication/json429Rate limit exceededapplication/json