Show bulk update scope for pay rates

Authorizations

Authorization

string

header

required

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

Body

application/json

business_entity_id

string

required

work_assignments

object

required

Hide child attributes

work_assignments.exclude

object

Hide child attributes

work_assignments.exclude.ids

string[]

work_assignments.exclude.payee_type

enum<string>

Available options:

contractor,

employee

work_assignments.exclude.pay_schedule_id

string

work_assignments.exclude.archived

boolean

work_assignments.exclude.payee_names

string

has_business_preset

boolean

business_presets

object

Hide child attributes

business_presets.include

object

Hide child attributes

business_presets.include.ids

(string | null)[]

business_presets.exclude

object

Hide child attributes

business_presets.exclude.ids

(string | null)[]

expense_accounting_codes

object

Hide child attributes

expense_accounting_codes.include

object

Hide child attributes

expense_accounting_codes.include.ids

(string | null)[]

expense_accounting_codes.exclude

object

Hide child attributes

expense_accounting_codes.exclude.ids

(string | null)[]

liability_accounting_codes

object

Hide child attributes

liability_accounting_codes.include

object

Hide child attributes

liability_accounting_codes.include.ids

(string | null)[]

liability_accounting_codes.exclude

object

Hide child attributes

liability_accounting_codes.exclude.ids

(string | null)[]

effective_on

string<date>

not_effective_on

string<date>

effective_from

string

The date from which this pay rate is applied to Pay Stubs.

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: effective_from=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: effective_from[gte]=2024-01-01&effective_from[lt]=2024-12-31

effective_to

string

The date after which this pay rate is no longer applied and can no longer be used to create Earning Line Items. null if the pay rate applies indefinitely.

Date filters support two formats: Exact Date Match: Provide a well-formatted date in YYYY-MM-DD format for an exact match. Example: effective_to=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: effective_to[gte]=2024-01-01&effective_to[lt]=2024-12-31

subtypes

object

Hide child attributes

subtypes.include

string[]

subtypes.exclude

string[]

ids

object

Hide child attributes

ids.include

string[]

ids.exclude

string[]

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 ("pay_rate").

data.data

Pay Rate · object

Hide child attributes

data.data.work_assignment

object

Hide child attributes

data.data.work_assignment.id

string

read-only

The unique identifier of the object in Nmbr.

data.data.work_assignment.object

string

read-only

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

data.data.title

string

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.type

enum<string>

Whether this is a salary or hourly pay rate. Determines how rate is interpreted.

Available options:

hourly,

salary

data.data.rate

number<decimal>

The annual salary when type is salary, or the hourly wage when type is hourly.

data.data.expected_hours_per_week

number<decimal>

The expected number of working hours per week. Must be greater than 0 for salary pay rates. Used to calculate the equivalent hourly rate from salaries for overtime.

data.data.is_editable

boolean

Whether the pay rate's type, rate, and effective_from can be modified. Once the pay rate has been used on a non-draft Payroll, these fields are locked.

data.data.is_deletable

boolean

Whether the pay rate can be deleted. A pay rate may not be deleted once it has been used on a non-draft Payroll.

data.data.effective_from

string<date>

The date from which this pay rate is applied to Pay Stubs.

data.data.earliest_valid_effective_to

string<date>

The earliest date that effective_to may be set to, based on the most recent non-draft Payroll period in which this pay rate was active.

data.data.effective_to

string<date> | null

The date after which this pay rate is no longer applied and can no longer be used to create Earning Line Items. null if the pay rate applies indefinitely.

data.data.business_preset

any

data.data.expense_accounting_code

any

data.data.liability_accounting_code

any

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.