Get salary record form data
accounting:payrolls.readhttps://api.holded.com/api/v2/salary-records/form-dataReturns the defaults needed to create a salary record: the top-level result/counterpart account (`default_accounting_account_id`, e.g. "465 Remuneraciones pendientes de pago") and the default payroll lines (`default_lines`) with the accounting account, tax key and description per line type, resolved from the account's payroll scheme. Call this before creating a salary record and use the returned accounting account IDs — never ask the user for them. They come from here, or from the employee's `payroll_accounts` when configured (employee-specific accounts take precedence). Amounts in `default_lines` are placeholders ("0") and must be replaced with the amounts the user provides.
Request
import requests
url = "https://api.holded.com/api/v2/salary-records/form-data"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Responses
Response
{
"default_accounting_account_id": "507f1f77bcf86cd799439013",
"default_lines": [
{
"type": "salary",
"amount": "0",
"accounting_account_id": "507f1f77bcf86cd799439014",
"tax_key": "e_salario",
"description": "Salario"
}
]
}Success responses
200Salary record creation defaultsapplication/jsonDefault top-level accounting account for the salary record: the result/counterpart account where the net payable is posted (e.g. "465 Remuneraciones pendientes de pago"). Use it as `accounting_account_id` when creating, unless the employee has its own `payroll_accounts.result` configured.
Default payroll lines from the account payroll scheme. One entry per line type with the accounting account, tax key and description already resolved — copy them verbatim into the create request. The "0" amounts are NOT usable values: you MUST ask the user for the real amount of every line and replace each "0" before creating. Never submit a line with amount "0".
Line type (e.g. salary, retention, tax, companytax)
Placeholder amount, always "0"
Default accounting account for this line type
Default tax key for this line type (e.g. e_salario, e_retencion). Copy it verbatim into the create request.
Default line description (concept label, e.g. "Salario", "Total S.S."). Copy it verbatim into the create request.
Error responses
401Invalid or missing API keyapplication/json403Insufficient permissionsapplication/json429Rate limit exceededapplication/json