Skip to main content
GET
/
work_assignments
List work assignments
curl --request GET \
  --url https://sandbox.nmbr.co/services/payroll/work_assignments \
  --header 'Authorization: Bearer <token>'
{
  "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": "/work_assignments?employee_id=<id>&page=1",
    "last": "/work_assignments?employee_id=<id>&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.

Query Parameters

​
business_entity_id
string
​
pay_schedule_id
string
​
employee_id
string
​
contractor_id
string
​
payee_type
enum<string>

Filter results by payee type.

Available options:
contractor,
employee
​
search_payee_names
string
​
external_ref
string
​
tag_id
string
​
tag_group_id
string
​
include_archived
boolean
​
archived_at
object

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

Sort order is specified using the format sort=field[:direction][,field[:direction],...] where field is the name of the field to sort by and direction is the optional sort direction (asc or desc).

Available options:
payee.default,
payee.first_name,
payee.last_name
​
expand
enum<string>[]
Available options:
business_entity,
contractor,
effective_tax_properties,
employee,
pay_rates,
pay_schedule,
pay_split,
remittance_accounts,
tag_assignment,
tax_properties

Response

200 - application/json

OK

​
object
string
read-only

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

​
data
object[]