Show bulk create scope for deductions

curl --request POST \
  --url https://sandbox.nmbr.co/services/payroll/deductions/bulk/create/scope \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business_entity_id": "<id>",
  "work_assignments": {
    "include": "all"
  }
}
'

{
  "object": "list",
  "data": [
    {
      "id": "<id>",
      "object": "work_assignment",
      "data": {
        "title": null,
        "employee": {
          "id": "<id>",
          "object": "employee",
          "links": {
            "self": "/employees/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "current_tax_jurisdiction": "ca_on",
        "is_primary": true,
        "accrued_vacation_pay": 0,
        "paid_vacation_pay": 0,
        "first_non_draft_period_start": null,
        "last_non_draft_period_end": null,
        "available_tax_properties": [
          "ca::province_of_employment",
          "ca::province_of_work",
          "ca::federal_oc_surtax_exempt",
          "ca::cpp_exempt",
          "ca::ei_exempt",
          "ca::qc::qpp_exempt",
          "ca::qc::qpip_exempt",
          "ca::nt::territorial_payroll_tax",
          "ca::nu::territorial_payroll_tax",
          "ca::federal::additional_tax",
          "ca::federal::claim_amount",
          "ca::federal::total_income_less_than_total_claim_amount",
          "ca::federal::annual_deduction_at_source",
          "ca::statutory_holiday_pay",
          "ca::first_nation_exemptions",
          "ca::ab::workers_compensation_class",
          "ca::bc::workers_compensation_class",
          "ca::mb::workers_compensation_class",
          "ca::nb::workers_compensation_class",
          "ca::nl::workers_compensation_class",
          "ca::ns::workers_compensation_class",
          "ca::nt::workers_compensation_class",
          "ca::nu::workers_compensation_class",
          "ca::on::workers_compensation_class",
          "ca::pe::workers_compensation_class",
          "ca::qc::workers_compensation_class",
          "ca::sk::workers_compensation_class",
          "ca::yt::workers_compensation_class",
          "ca::on::claim_amount",
          "ca::on::dependent_children_credit",
          "ca::on::impaired_dependants_credit"
        ],
        "external_ref": null,
        "archived_at": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/work_assignments/<id>"
      }
    }
  ],
  "links": {
    "first": "http://localhost/deductions/bulk/create/scope?business_entity_id=<id>&work_assignments%5Binclude%5D=all&page=1",
    "last": "http://localhost/deductions/bulk/create/scope?business_entity_id=<id>&work_assignments%5Binclude%5D=all&page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1,
    "has_more": false
  }
}

POST

deductions

bulk

create

scope

Show bulk create scope for deductions

curl --request POST \
  --url https://sandbox.nmbr.co/services/payroll/deductions/bulk/create/scope \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business_entity_id": "<id>",
  "work_assignments": {
    "include": "all"
  }
}
'

{
  "object": "list",
  "data": [
    {
      "id": "<id>",
      "object": "work_assignment",
      "data": {
        "title": null,
        "employee": {
          "id": "<id>",
          "object": "employee",
          "links": {
            "self": "/employees/<id>"
          }
        },
        "pay_schedule": {
          "id": "<id>",
          "object": "pay_schedule",
          "links": {
            "self": "/pay_schedules/<id>"
          }
        },
        "business_entity": {
          "id": "<id>",
          "object": "business_entity",
          "links": {
            "self": "/business_entities/<id>"
          }
        },
        "current_tax_jurisdiction": "ca_on",
        "is_primary": true,
        "accrued_vacation_pay": 0,
        "paid_vacation_pay": 0,
        "first_non_draft_period_start": null,
        "last_non_draft_period_end": null,
        "available_tax_properties": [
          "ca::province_of_employment",
          "ca::province_of_work",
          "ca::federal_oc_surtax_exempt",
          "ca::cpp_exempt",
          "ca::ei_exempt",
          "ca::qc::qpp_exempt",
          "ca::qc::qpip_exempt",
          "ca::nt::territorial_payroll_tax",
          "ca::nu::territorial_payroll_tax",
          "ca::federal::additional_tax",
          "ca::federal::claim_amount",
          "ca::federal::total_income_less_than_total_claim_amount",
          "ca::federal::annual_deduction_at_source",
          "ca::statutory_holiday_pay",
          "ca::first_nation_exemptions",
          "ca::ab::workers_compensation_class",
          "ca::bc::workers_compensation_class",
          "ca::mb::workers_compensation_class",
          "ca::nb::workers_compensation_class",
          "ca::nl::workers_compensation_class",
          "ca::ns::workers_compensation_class",
          "ca::nt::workers_compensation_class",
          "ca::nu::workers_compensation_class",
          "ca::on::workers_compensation_class",
          "ca::pe::workers_compensation_class",
          "ca::qc::workers_compensation_class",
          "ca::sk::workers_compensation_class",
          "ca::yt::workers_compensation_class",
          "ca::on::claim_amount",
          "ca::on::dependent_children_credit",
          "ca::on::impaired_dependants_credit"
        ],
        "external_ref": null,
        "archived_at": null,
        "created_at": "2026-01-01T00:00:00.000000Z",
        "updated_at": "2026-01-01T00:00:00.000000Z"
      },
      "links": {
        "self": "/work_assignments/<id>"
      }
    }
  ],
  "links": {
    "first": "http://localhost/deductions/bulk/create/scope?business_entity_id=<id>&work_assignments%5Binclude%5D=all&page=1",
    "last": "http://localhost/deductions/bulk/create/scope?business_entity_id=<id>&work_assignments%5Binclude%5D=all&page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1,
    "has_more": false
  }
}

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

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

data.data

Deduction · 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.frequency

enum<string>

The frequency at which this deduction is applied to Pay Stubs. When per_month, the amount is distributed across selected Payrolls in the calendar month. per_month is only valid when amount_type is fixed; percent and per-hour deductions apply to every paycheque regardless of frequency.

Available options:

once,

per_month,

per_payroll

data.data.date_basis

enum<string> | null

Which payroll date determines the calendar month for the allocation. Applies only to fixed-amount per_month deductions.

Available options:

by_pay_date,

by_period_end_date,

by_period_start_date

data.data.pay_period_cadence

object

Which pay periods within the month receive the allocation. An array of 1-based positions; -1 is the final period. Applies only to fixed-amount per_month deductions.

data.data.deduction_type

object

The type of deduction, which determines how it is categorized and remitted.

Hide child attributes

data.data.deduction_type.id

string

read-only

The unique identifier of the object in Nmbr.

data.data.deduction_type.object

string

read-only

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

data.data.deduction_type.data

Deduction Type · object

Hide child attributes

data.data.deduction_type.data.type

string | null

The string identifier for this deduction type.

data.data.deduction_type.data.label

string | null

The human-readable display name for this deduction type.

data.data.deduction_type.data.locale

string | null

data.data.amount

number<decimal>

The deduction amount per occurrence. When amount_type is percentage, this is interpreted as a percentage of the income basis rather than a fixed dollar amount.

data.data.amount_type

enum<string>

Whether amount is a fixed dollar value (fixed) or a percentage of the income basis (percentage).

Available options:

fixed,

fixed_per_hour,

percent

data.data.income_basis

enum<string>

Determines the income used as the base for percentage-based deductions. regular_earnings includes only salary and wage earnings. all_earnings includes all earnings. total_income includes all earnings, taxable allowances, and taxable reimbursements. none doesn't include any line items, and can be used with income_includes for completely custom definitions of income.

Available options:

all_earnings,

none,

regular_earnings,

total_income

data.data.income_includes

object

An optional list of specific earnings, allowances, and other line item types to include in the income calculation in addition to those included via income_basis.

data.data.income_subtractions

object

An optional list of deductions and benefits to subtract from the income before the deduction amount is calculated.

data.data.income_statutory_withholdings

enum<string>

Whether to subtract statutory withholdings (CPP, EI, income tax) from the income before the deduction amount is calculated.

Available options:

all,

none

data.data.income_exemption_amount

number<decimal> | null

A fixed dollar amount to exempt from the income before calculating the deduction.

data.data.income_exemption_percent

number<decimal> | null

A percentage of the income to exempt before calculating the deduction amount.

data.data.effective_from

string<date>

The date from which this deduction is applied to Pay Stubs.

data.data.effective_to

string<date> | null

The date after which this deduction is no longer applied. null if the deduction applies indefinitely.

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

any

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.

Bulk create deductions Bulk update deductions

⌘I