Jobs

Prev Next
Get
/public/v1/labor/jobs

Retrieves a paged list of job titles with location, GL account, and responsibility data. At least one date filter (ModifiedOnStart or ModifiedOnEnd) is required.

Security

The requesting user must have the following permission to retrieve job titles:

  • Labor → Jobs → View Jobs
Security
HTTP
Type Bearer
Header parameters
x-r365-context-tenant-id
stringRequired

Identifies the R365 tenant the request applies to. Required on every request.

Query parameters
ModifiedOnStart
string (date)

Earliest modified date to return. When provided without ModifiedOnEnd, scopes results to that single day

ModifiedOnEnd
string (date)

Latest modified date to return. When provided without ModifiedOnStart, scopes results to that single day

locations
string

Comma-separated list of location identifiers (GUIDs) to include. When omitted, all accessible locations are included

legalEntities
string

Comma-separated list of legal entity identifiers (GUIDs) to include. When omitted, all accessible legal entities are included

pageSize
integer (int32)

Maximum number of top-level objects to return in one page.

Minimum1.0
Maximum250.0
Default250
continuationToken
string

Opaque token from NextLink of a prior response. Omit on the first request; pass verbatim to fetch the next page

Responses
200

Paged response containing job titles for the current page and a link to the next page when available.

Expand All
object
data
Array of object (JobExternalResponse)

Job titles for the current page.

object
id
string (uuid)

Unique identifier (GUID) of the job title.

name
string

Job title name.

code
string | null

Job code.

department
string | null

Department the job belongs to.

payRate
number (double)

Base pay rate for the job title.

excludeFromSchedule
boolean

Indicates whether the job title is excluded from scheduling.

excludeFromPOSImport
boolean

Indicates whether the job title is excluded from POS import.

location
object (JobLocation)
id
string (uuid)

Unique identifier (GUID) of the location.

name
string

Location display name.

number
string

Location number.

generalLedgerAccount
object (GeneralLedgerAccount)
id
string (uuid)

Unique identifier (GUID) of the GL account.

name
string

GL account name.

number
string

GL account number.

glType
string

GL account type.

responsibilities
Array of object | null

Responsibilities assigned to the job title. Null when no responsibilities are configured.

object
responsibility
string | null

Responsibility description.

nextLink
string | null

Relative URL to retrieve the next page of results. Null when this is the last page.

400

Bad Request — a parameter value is malformed, of the wrong type, or outside its allowed range.

401

Unauthorized — the bearer token is missing, invalid or expired, or is not valid for the specified tenant.

403

Forbidden — the caller lacks the permission required for this operation.

404

Not Found — the requested resource does not exist, or the supplied continuation token is unknown or has expired.

409

Conflict — the request conflicts with the current state of the resource and cannot be applied.

422

Unprocessable Entity — a required parameter is missing, or a supplied parameter value is invalid.

429

Too Many Requests — the caller has exceeded the rate limit; retry after a short delay.

500

Internal Server Error — an unexpected error occurred while processing the request.