---
updatedAt: 2026-02-10T18:50:36.000Z
agentTools:
  siteIndex: https://developer.paylocity.com/llms.txt
  projectIndex: https://developer.paylocity.com/integrations/llms.txt
---

# Get Job Codes [Batch]

**Summary Description**

The GET Job Code List by Company ID endpoint, retrieves a comprehensive list of Job Codes from the Paylocity system with each call. Pagination can be achieved by using the "jobs" 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**

- The GET a list of Job Codes API endpoint allows users to fetch specific Job Code details from a client's Paylocity instance. To use this endpoint, the Paylocity Company ID must be specified
- The 'Get Job Codes List by Company ID' endpoint empowers API users to fetch a comprehensive list of Job Codes alongside their relevant data


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Level Information",
    "version": "v1"
  },
  "servers": [
    {
      "url": "dc1demogwext.paylocity.com"
    }
  ],
  "paths": {
    "/apiHub/payroll/v1/companies/{companyId}/jobs": {
      "get": {
        "tags": [
          "Job Codes"
        ],
        "summary": "Get Job Codes [Batch]",
        "description": "**Summary Description**\n\nThe GET Job Code List by Company ID endpoint, retrieves a comprehensive list of Job Codes from the Paylocity system with each call. Pagination can be achieved by using the \"jobs\" 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\n\n**Use Cases**\n\n- The GET a list of Job Codes API endpoint allows users to fetch specific Job Code details from a client's Paylocity instance. To use this endpoint, the Paylocity Company ID must be specified\n- The 'Get Job Codes List by Company ID' endpoint empowers API users to fetch a comprehensive list of Job Codes alongside their relevant data\n",
        "x-explorer-enabled": false,
        "parameters": [
          {
            "name": "companyId",
            "in": "path",
            "description": "The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.\r\n                **Allowable Values:**\r\n                9 char max.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "A12345"
          },
          {
            "name": "testMode",
            "in": "header",
            "description": "If true all responses are mocked and generated randomly.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "Authorization token. Ex. Bearer ...",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "description": "The API Filter, by defining specific conditions, enables developers to fine-tune data from API calls for more precise results, enhancing application efficiency and user-friendliness. For more information review the Filtering page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Number of jobs per page.\r\n                **Default Value:** 20\r\n                **Maximum Value:** 100",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 20
            },
            "example": 5
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Pagination offset.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/JobCodeDto"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CompanyAddressDto": {
        "type": "object",
        "properties": {
          "line1": {
            "type": "string",
            "description": "The address where the job code will be used",
            "nullable": true
          },
          "line2": {
            "type": "string",
            "description": "The address where the job code will be used",
            "nullable": true
          },
          "city": {
            "type": "string",
            "description": "The city where the job code will be used",
            "nullable": true
          },
          "state": {
            "type": "string",
            "description": "The state where the job code will be used",
            "nullable": true
          },
          "zip": {
            "type": "string",
            "description": "The zip code where the job code will be used",
            "nullable": true
          },
          "county": {
            "type": "string",
            "description": "The county where the job code will be used",
            "nullable": true
          },
          "country": {
            "type": "string",
            "description": "The country where the job code will be used",
            "nullable": true
          }
        },
        "additionalProperties": {
          "type": "object",
          "nullable": true
        },
        "description": "Address"
      },
      "JobCodeDto": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "string",
            "description": "The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity",
            "nullable": true
          },
          "code": {
            "type": "string",
            "description": "A Job Code may contain up to 20 alpha-numeric characters. Spaces or special characters are not allowed",
            "nullable": true
          },
          "description": {
            "type": "string",
            "description": "The Job Code description may contain up to 40 alpha-numeric characters. Spaces or special characters are not allowed",
            "nullable": true
          },
          "isActive": {
            "type": "boolean",
            "description": "Active (Yes/No). The job code is currently active or inactive",
            "nullable": true
          },
          "isCertified": {
            "type": "boolean",
            "description": "Certified Job (Yes/No). This is a certified job code as per the CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) job costing report by industry",
            "nullable": true
          },
          "payEntry": {
            "$ref": "#/components/schemas/PayEntryDto"
          },
          "address": {
            "$ref": "#/components/schemas/CompanyAddressDto"
          },
          "payrollBasedJournal": {
            "$ref": "#/components/schemas/PayrollBasedJournalDto"
          }
        },
        "additionalProperties": {
          "type": "object",
          "nullable": true
        },
        "description": "Job Details"
      },
      "PayEntryDto": {
        "type": "object",
        "properties": {
          "shift": {
            "type": "string",
            "description": "This field is used to enter an override company-defined shift code to be charged by the employee",
            "nullable": true
          },
          "rateCode": {
            "type": "string",
            "description": "The employee’s pay rate. If no rate is entered, the employees base rate will be used",
            "nullable": true
          },
          "rate": {
            "type": "number",
            "description": "The rate of pay for the job code",
            "format": "double",
            "nullable": true
          },
          "addingRateConstant": {
            "type": "number",
            "description": "Rate + or + Is employee pay rate + the SD Schedule Differential plus or times the bonus",
            "format": "double",
            "nullable": true
          },
          "multiplyingRateConstant": {
            "type": "number",
            "description": "Rate X or + Is employee pay rate X the SD Schedule Differential plus or times the bonus",
            "format": "double",
            "nullable": true
          },
          "workerComputedCode": {
            "type": "string",
            "description": "The company defined workers comp code for work performed by the employee",
            "nullable": true
          },
          "tax": {
            "$ref": "#/components/schemas/TaxDto"
          }
        },
        "additionalProperties": {
          "type": "object",
          "nullable": true
        },
        "description": "Override Pay Entry Only"
      },
      "PayrollBasedJournalDto": {
        "type": "object",
        "properties": {
          "jobTitleCode": {
            "type": "string",
            "description": "This is a Job Title Code for which the certified job code CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) will be utilized to calculate labor costs",
            "nullable": true
          },
          "facilityId": {
            "type": "string",
            "description": "This is a Facility id for which the certified job code CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) will be utilized to calculate labor costs",
            "nullable": true
          },
          "stateId": {
            "type": "string",
            "description": "This is a State ID for which the certified job code CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) will be utilized to calculate labor costs",
            "nullable": true
          }
        },
        "additionalProperties": {
          "type": "object",
          "nullable": true
        },
        "description": "CMS/PBJ Data Only"
      },
      "TaxDto": {
        "type": "object",
        "properties": {
          "state": {
            "type": "string",
            "description": "State",
            "nullable": true
          },
          "local1": {
            "type": "string",
            "description": "This is the local tax code used for the job code",
            "nullable": true
          },
          "local2": {
            "type": "string",
            "description": "This  is the second local tax code used for the job code",
            "nullable": true
          },
          "local3": {
            "type": "string",
            "description": "This is the third local tax code  used for the job code",
            "nullable": true
          }
        },
        "additionalProperties": {
          "type": "object",
          "nullable": true
        },
        "description": "State Tax"
      }
    }
  }
}
```