List reimbursement line items

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

pay_stub_id

string

payroll_id

string

payroll_status

enum<string>

Available options:

approved,

draft,

failed,

paid,

partially_paid,

processing

payroll_type

enum<string>

Available options:

correction,

historical,

off_cycle,

regular

payroll_period_start

object

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: payroll_period_start=2024-01-01 Use an array-like syntax to specify a range with one or more comparison operators:

gt (greater than)
gte (greater than or equal to)
lte (less than or equal to)
lt (less than) Example: payroll_period_start[gte]=2024-01-01&payroll_period_start[lt]=2024-12-31

payroll_period_end

object

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: payroll_period_end=2024-01-01 Use an array-like syntax to specify a range with one or more comparison operators:

gt (greater than)
gte (greater than or equal to)
lte (less than or equal to)
lt (less than) Example: payroll_period_end[gte]=2024-01-01&payroll_period_end[lt]=2024-12-31

payroll_pay_date

object

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: payroll_pay_date=2024-01-01 Use an array-like syntax to specify a range with one or more comparison operators:

gt (greater than)
gte (greater than or equal to)
lte (less than or equal to)
lt (less than) Example: payroll_pay_date[gte]=2024-01-01&payroll_pay_date[lt]=2024-12-31

pay_schedule_id

string

work_assignment_id

string

employee_id

string

contractor_id

string

business_entity_id

string

has_business_preset

boolean

business_preset_id

string

include_types

enum<string>

Available options:

health_spending_account,

non_taxable_reimbursement,

professional_membership,

taxable_reimbursement,

transit_pass,

wellness_spending_account

exclude_types

enum<string>

Available options:

health_spending_account,

non_taxable_reimbursement,

professional_membership,

taxable_reimbursement,

transit_pass,

wellness_spending_account

external_ref

string

earned_on

object

Only return line items with an earned_on date matching the filter.

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: earned_on=2024-01-01 Use an array-like syntax to specify a range with one or more comparison operators:

gt (greater than)
gte (greater than or equal to)
lte (less than or equal to)
lt (less than) Example: earned_on[gte]=2024-01-01&earned_on[lt]=2024-12-31

expand

enum<string>[]

Available options:

business_preset,

custom_expense_accounting_code,

custom_liability_accounting_code,

custom_tag_assignment,

expense_accounting_code,

liability_accounting_code,

managed_expense_accounting_code,

managed_liability_accounting_code,

managed_tag_assignment,

pay_stub,

recurrence,

source_adjustment,

tag_assignment,

tag_assignment_amounts

Response

200 - application/json

object

string

read-only

The type of the object in Nmbr ("list").

data

object[]

Hide child attributes

data.id

string

read-only

The unique identifier of the object in Nmbr.

data.object

string

read-only

The type of the object in Nmbr ("reimbursement_line_item").

data.data

Default · object

Default
With pay_stub expanded
With recurrence expanded
With business_preset expanded
With source_adjustment expanded
With expense_accounting_code expanded
With managed_expense_accounting_code expanded
With custom_expense_accounting_code expanded
With liability_accounting_code expanded
With managed_liability_accounting_code expanded
With custom_liability_accounting_code expanded
With tag_assignment expanded
With managed_tag_assignment expanded
With custom_tag_assignment expanded
With tag_assignment_amounts expanded

Hide child attributes

data.data.pay_stub

object

Hide child attributes

data.data.pay_stub.id

string

read-only

The unique identifier of the object in Nmbr.

data.data.pay_stub.object

string

read-only

The type of the object in Nmbr ("pay_stub").

data.data.line_item_type

string | null

data.data.is_managed

boolean

Whether this line item was generated by a Reimbursement recurrence and calculated automatically. When true, only custom_amount can be modified and the line item cannot be deleted.

data.data.amount

number<decimal> | null

The effective amount for this line item. Returns custom_amount if set, otherwise managed_amount. Read-only.

data.data.custom_amount

number<decimal> | null

An override for managed_amount. When set, amount reflects this value instead of managed_amount.

data.data.managed_amount

number<decimal> | null

The amount calculated by the system or set by the linked Reimbursement recurrence. Read-only; set custom_amount to override.

data.data.accrued_vacation_pay

number<decimal> | null

The vacation pay accrued on this line item, calculated based on the Work Assignment's Vacation Pay Settings.

data.data.reimbursement_type

object

The type of reimbursement for this line item.

Hide child attributes

data.data.reimbursement_type.id

string

read-only

The unique identifier of the object in Nmbr.

data.data.reimbursement_type.object

string

read-only

The type of the object in Nmbr ("reimbursement_type").

data.data.reimbursement_type.data

Reimbursement Type · object

Hide child attributes

data.data.reimbursement_type.data.type

string | null

The string identifier for this reimbursement type.

data.data.reimbursement_type.data.label

string | null

The human-readable display name for this reimbursement type.

data.data.recurrence

any

data.data.title

string | null

Maximum string length: 255

data.data.title_translations

object

Optional translations for the title property.

Hide child attributes

data.data.title_translations.en

string

Maximum string length: 255

data.data.title_translations.fr

string

Maximum string length: 255

data.data.title_translated

string

read-only

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.

data.data.business_preset

any

data.data.source_adjustment

any

data.data.expense_accounting_code

any

The effective expense accounting code. Returns the user-set value if present, otherwise the system-derived value. Writes to this field set the user override.

data.data.managed_expense_accounting_code

any

The expense accounting code derived by the system from accounting code rules and presets. Read-only.

data.data.custom_expense_accounting_code

any

User-set expense accounting code that overrides the system-derived value.

data.data.liability_accounting_code

any

The effective liability accounting code. Returns the user-set value if present, otherwise the system-derived value. Writes to this field set the user override.

data.data.managed_liability_accounting_code

any

The liability accounting code derived by the system from accounting code rules and presets. Read-only.

data.data.custom_liability_accounting_code

any

User-set liability accounting code that overrides the system-derived value.

data.data.component_settings

object

Settings specific to the Nmbr component.

Hide child attributes

data.data.component_settings.attributes_locked

boolean

Whether the line item is locked and cannot be edited in the component.

data.data.earned_on

any

The effective earned-on date for this line item. Returns custom_earned_on if set, otherwise managed_earned_on. Read-only.

data.data.managed_earned_on

string<date> | null

The earned-on date set by the system. Read-only; set custom_earned_on to override.

data.data.custom_earned_on

string<date> | null

An override for managed_earned_on. When set, earned_on reflects this value instead of managed_earned_on. Must fall within the payroll's pay period.

data.data.external_ref

string | null

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.

Maximum string length: 255

data.data.created_at

string<dateTime>

read-only

The date and time the object was created in Nmbr.

data.data.updated_at

string<dateTime>

read-only

The date and time the object was last updated in Nmbr.