---
title: "Get Position Codes"
method: GET
path: "/apiHub/positionManagement/v1/companies/{companyId}/positions"
tags: ["Payroll/HR"]
---

# Get Position Codes

`GET /apiHub/positionManagement/v1/companies/{companyId}/positions`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apiHub/positionManagement/v1/companies/{companyId}/positions`
- Auth: none declared

**Summary Description**

The GET Position Codes List by Company ID endpoint, retrieves a comprehensive list of Position Codes from the Paylocity system with each call. Position codes are alphanumeric or numeric designations employed by corporations to classify and oversee various job responsibilities and positions within their workforce. These codes fulfill several crucial functions in the domains of human resources, talent management, and organizational structure.
Pagination can be achieved by using the "positions" parameter and specifying the values of "limit" and "offset" to decide the quantity of records to be retrieved. The utilization of the "limit" option permits the user to restrict the quantity of rows that are retrieved from a query, whereas the "offset" option enables the omission of a designated number of rows preceding the commencement of the result set. The utilization of both the limit and offset parameters in a query allows for the skipping of rows as well as the restriction of the number of rows returned.

**Use Cases**

- Human Resources Management: HR departments often use position codes to categorize and manage job roles within an organization. The API can facilitate the creation, updating, and retrieval of position codes, ensuring that job roles are accurately documented and maintained.
- Payroll and Compensation Management: Position codes are crucial for determining salary scales and compensation packages. The API can be used to link position codes with salary information, simplifying payroll processing and compensation management.
- Recruitment and Onboarding: When hiring new employees, organizations can use the API to identify vacant positions and manage the recruitment process more efficiently. It can help HR teams keep track of available job roles and their requirements.
- Compliance and Reporting: Many regulatory agencies require organizations to report on specific job roles and positions. The API can assist in generating compliance reports by providing access to accurate position code data.

## Path parameters

- `companyId` string, required

## Query parameters

- `includeTotalCount` boolean
- `limit` integer
- `offset` integer

## Headers

- `Authorization` string
- `testMode` boolean

## Response `200`

OK

- PositionsDto[]
  - `flsaOvertimeExempt` boolean, nullable: Indicator of overtime exemption.
  - `fte` number, double, nullable: Full-time equivalent value.
  - `approvedDate` string, date-time, nullable: Date when the position was approved.
  - `effectiveDate` string, date-time, nullable: Effective date of the position.
  - `closedDate` string, date-time, nullable: Date when the position was closed.
  - `supervisorPosition` boolean, nullable: Indicator of supervisor position.
  - `code` string, nullable: Code representing the position.
  - `title` string, nullable: Title or name of the position.
  - `eeoClass` EeoClassDto
    - `eeoClassKey` integer, nullable: Unique identifier for EEO class.
    - `legacyEEOClassId` integer, nullable: Legacy EEO class identifier.
    - `clientId` integer, nullable: Client identifier for EEO class. ClientId is the company set ID when the client is a company set. If the client is a standalone company, then clientId will be the same as the companyId.
    - `code` string, nullable: Code representing EEO class.
    - `description` string, nullable: Description of EEO class.
    - `active` boolean, nullable: Indicator of EEO class activity.
    - `positionsAssigned` integer, nullable: Number of positions assigned to EEO class.
    - `eeoClassCompanies` ResourceCompanyDto[], nullable: List of EEO class companies.
      - `companyId` string, nullable: Company ID associated with the EEO class company.
      - `active` boolean, nullable: Indicates if the EEO class company is active.
  - `workersCompensationCode` WorkersCompensationCodeDto
    - `clientId` integer, nullable: ClientId is the company set ID when the client is a company set. If the client is a standalone company, then clientId will be the same as the companyId.
    - `code` string, nullable: Code representing a specific category.
    - `description` string, nullable: Detailed label providing context to the client.
    - `active` boolean, nullable: Indicator of the client's active status.
    - `positionsAssigned` integer, nullable: Number of positions assigned to the client.
  - `careerLevel` CareerLevelDto
    - `careerLevelKey` integer, nullable: Career level key.
    - `clientId` integer, nullable: Client ID associated with career level.
    - `code` string, nullable: Career level code.
    - `name` string, nullable: Name of the career level.
    - `description` string, nullable: Description of the career level.
    - `positionsAssigned` integer, nullable: Number of positions assigned to the career level.
    - `active` boolean, nullable: Indicates if the career level code is active.
  - `families` PositionFamilyDto[], nullable: List of position families.
    - `positionFamilyKey` integer, nullable: Unique identifier for position family.
    - `clientId` integer, nullable: ClientId is the company set ID when the client is a company set. If the client is a standalone company, then clientId will be the same as the companyId.
    - `code` string, nullable: Code representing position family.
    - `active` boolean, nullable: Indicator of position family activity.
    - `name` string, nullable: Name of the position family.
    - `description` string, nullable: Description of the position family.
    - `positionsAssigned` integer, nullable: Number of positions assigned to position family.
  - `standardOccupationalClassification` StandardOccupationalClassificationDto
    - `standardOccupationalClassificationKey` integer, nullable: Standard occupational classification key.
    - `group` string, nullable: Group associated with the standard occupational classification.
    - `code` string, nullable: Standard occupational classification code.
    - `title` string, nullable: Title of the standard occupational classification.

---

[API](https://skmtc.dev/paylocity/apis/company-level-information.md) - [All operations](https://skmtc.dev/paylocity/apis/company-level-information/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/company-level-information/revisions/b0d2a79e4eac?raw)