Worker Job Titles

Endpoint: https://api.paychex.com/companies/{companyId}/jobtitles

Verbs supported: GET

GET: Array of job titles set at the company level which a worker could be assigned.

Request:

Element NameTypeDescription
companyId stringThe ID of the company.


Response: Worker Job Title Profile  

Endpoint: https://api.paychex.com/companies/{companyId}/jobtitles/{workerJobTitleId}

Verbs supported: GET

GET: Information about a single Job Title.

Request:

Element NameTypeDescription
companyId stringThe ID of the company.
workerJobTitleIdstringThe ID of the worker job title.

Response: Worker Job Title Profile  

Response

Profile: Worker Statuses

The state representation of allowed worker job titles configured for the company.
Element NameTypeDescription
jobTitleIdstringThe unique identifier associated with this job titles representation.
startDatedateDate when this job is available to be assigned to a worker.
endDatedateDate when this job is no longer available to be assigned to a worker.
titlestringThe name of the title.
linksobjectNavigational links.

 

{
  "content": [
    {
      "jobTitleId": "00DWS906IMW2JSH8AQJ8",
      "startDate": "2010-01-01T00:00:00Z",
      "endDate": "2016-12-31T00:00:00Z",
      "title": "Archaeologist",
      "links": [
        {
          "rel": "self",
          "href": "https://api.paychex.com/companies/99Z5V9BTI8J2FCGESC05/jobtitles/00DWS906IMW2JSH8AQJ8"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": "self",
      "href": "https://api.paychex.com/companies/99Z5V9BTI8J2FCGESC05/jobtitles"
    }
  ]
}