---
title: "Company Job Titles"
method: GET
path: "/companies/{companyId}/jobtitles"
tags: ["Company"]
---

# Company Job Titles

`GET /companies/{companyId}/jobtitles`

## Request

- Base URL: `https://api.paychex.com`
- URL: `https://api.paychex.com/companies/{companyId}/jobtitles`
- Auth: none declared
- TypeScript: <https://skmtc.dev/paychex/apis/external-api/docs/companies/:companyId/jobtitles/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Path parameters

- `companyId` string, required

## Response `200`

successful operation

- object
  - `metadata` MetadataResource
    - `contentItemCount` integer
    - `pagination` PaginationMetadataResource
      - `offset` integer
      - `limit` integer
      - `itemCount` integer
      - `total` integer
  - `content` JobTitleResource: The state representation of allowed worker job titles configured for the company.
    - `jobTitleId` string: The unique identifier associated with this job titles representation.
    - `title` string: The name of the title.
    - `startDate` string, date-time: Date when this job is available to be assigned to a worker.
    - `endDate` string, date-time: Date when this job is no longer available to be assigned to a worker.
    - `links` Link[]
      - `rel` string
      - `href` string
      - `hreflang` string
      - `media` string
      - `title` string
      - `type` string
      - `deprecation` string
      - `profile` string
      - `name` string
  - `links` Link[]
    - `rel` string
    - `href` string
    - `hreflang` string
    - `media` string
    - `title` string
    - `type` string
    - `deprecation` string
    - `profile` string
    - `name` string

## Other responses

- `401`: Unauthorized
- `403`: User doesn't have access to this endpoint (API-2), Client has been end dated (API-68)
- `404`: Invalid resource ID (API-7)
- `405`: Unsupported method type (API-59)
- `406`: Unsupported Accept header
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/paychex/apis/external-api.md) - [All operations](https://skmtc.dev/paychex/apis/external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paychex/apis/external-api/revisions/07161d3e073f?raw)