curl --request GET \
--url https://sandbox.nmbr.co/services/payroll/allowances/{allowance} \
--header 'Authorization: Bearer <token>'{
"id": "<id>",
"object": "allowance",
"data": {
"work_assignment": {
"id": "<id>",
"object": "work_assignment",
"links": {
"self": "/work_assignments/<id>"
}
},
"allowance_type": {
"id": "<id>",
"object": "allowance_type",
"data": {
"type": "cell_phone_allowance",
"label": "Cell phone allowance"
},
"links": {
"self": "/allowance_types/cell_phone_allowance"
}
},
"title": "Cell phone allowance",
"title_translations": {
"en": "Cell phone allowance",
"fr": "Allocation de téléphone cellulaire"
},
"title_translated": "Cell phone allowance",
"amount": 75.25,
"frequency": "per_month",
"date_basis": "by_period_start_date",
"pay_period_cadence": [
1
],
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"business_preset": null,
"expense_accounting_code": null,
"liability_accounting_code": null,
"external_ref": "01KFNHG3MNRS84XF1ERW0M7HP0",
"created_at": "2026-01-01T00:00:00.000000Z",
"updated_at": "2026-01-01T00:00:00.000000Z"
},
"links": {
"self": "/allowances/<id>"
}
}Retrieve an allowance
curl --request GET \
--url https://sandbox.nmbr.co/services/payroll/allowances/{allowance} \
--header 'Authorization: Bearer <token>'{
"id": "<id>",
"object": "allowance",
"data": {
"work_assignment": {
"id": "<id>",
"object": "work_assignment",
"links": {
"self": "/work_assignments/<id>"
}
},
"allowance_type": {
"id": "<id>",
"object": "allowance_type",
"data": {
"type": "cell_phone_allowance",
"label": "Cell phone allowance"
},
"links": {
"self": "/allowance_types/cell_phone_allowance"
}
},
"title": "Cell phone allowance",
"title_translations": {
"en": "Cell phone allowance",
"fr": "Allocation de téléphone cellulaire"
},
"title_translated": "Cell phone allowance",
"amount": 75.25,
"frequency": "per_month",
"date_basis": "by_period_start_date",
"pay_period_cadence": [
1
],
"effective_from": "2026-01-01",
"effective_to": "2026-12-31",
"business_preset": null,
"expense_accounting_code": null,
"liability_accounting_code": null,
"external_ref": "01KFNHG3MNRS84XF1ERW0M7HP0",
"created_at": "2026-01-01T00:00:00.000000Z",
"updated_at": "2026-01-01T00:00:00.000000Z"
},
"links": {
"self": "/allowances/<id>"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
business_preset, expense_accounting_code, liability_accounting_code, tag_assignment, work_assignment Response
OK
The unique identifier of the object in Nmbr.
The type of the object in Nmbr ("allowance").
- Default
- With work_assignment expanded
- With business_preset expanded
- With expense_accounting_code expanded
- With liability_accounting_code expanded
- With tag_assignment expanded
Hide child attributes
Hide child attributes
The type of allowance, which determines how it is taxed and reported on Pay Stubs.
Hide child attributes
Hide child attributes
The unique identifier of the object in Nmbr.
The type of the object in Nmbr ("allowance_type").
The translation of the title property for the request locale. Computed using the values in title and title_translations and the value of the request's Accept-Language header.
The monetary amount applied each time this allowance is included on a Pay Stub.
The frequency at which this allowance is applied to Pay Stubs. When per_month, the amount is distributed evenly across all Payrolls in the calendar month.
once, per_month, per_payroll Which payroll date determines the calendar month for the allocation. Applies only to per_month recurrences.
by_pay_date, by_period_end_date, by_period_start_date Which pay periods within the month receive the allocation. An array of 1-based positions; -1 is the final period. Applies only to per_month recurrences.
The date from which this allowance is applied to Pay Stubs.
The date after which this allowance is no longer applied. null if the allowance applies indefinitely.
A reference to the object in an external system, e.g. the primary key of the object in your application's database. Nmbr doesn't use, validate, parse, or require this value to be unique - it simply stores it for your reference.
255The date and time the object was created in Nmbr.
The date and time the object was last updated in Nmbr.