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

# Get Rate Codes

**Summary Description**

The GET Rate Codes by list by Company ID endpoint allows users to retrieve a comprehensive list of Rate Codes details from a client's Paylocity instance. To use this endpoint, the Paylocity “rateCodes” parameter must be specified. Rate Codes are employed throughout multiple businesses to denote precise pricing or rate frameworks. Rate codes are vital for monitoring and overseeing various pricing alternatives, employee pay rates, packages, or promotions offered by businesses. These codes facilitate the optimization of pricing management, reservations, and financial transactions.

**Use Cases**

- Hotel room rates are typically categorized and differentiated using rate codes in the hospitality business. Each rate code corresponds to a distinct kind of room (such as standard, deluxe, or suite) or a special price arrangement (such as non-refundable, corporate, or promotional).
 -Seasonal Pricing: Rate codes can be utilized to enforce fluctuations in pricing based on different seasons. For instance, a hotel may utilize distinct rate codes to distinguish between rates during peak season and rates during off-peak season. 
 -Businesses frequently generate rate codes to facilitate special deals, packages, or promotions. These codes may encompass reductions, free perks, or combined offerings (e.g., "bed and breakfast" packages).
- A business would like to have different codes per shift work.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Level Information",
    "version": "v1"
  },
  "servers": [
    {
      "url": "dc1demogwext.paylocity.com"
    }
  ],
  "paths": {
    "/apiHub/corehr/v1/companies/{companyId}/rateCodes": {
      "get": {
        "tags": [
          "Payroll/HR"
        ],
        "summary": "Get Rate Codes",
        "description": "**Summary Description**\n\nThe GET Rate Codes by list by Company ID endpoint allows users to retrieve a comprehensive list of Rate Codes details from a client's Paylocity instance. To use this endpoint, the Paylocity “rateCodes” parameter must be specified. Rate Codes are employed throughout multiple businesses to denote precise pricing or rate frameworks. Rate codes are vital for monitoring and overseeing various pricing alternatives, employee pay rates, packages, or promotions offered by businesses. These codes facilitate the optimization of pricing management, reservations, and financial transactions.\n\n**Use Cases**\n\n- Hotel room rates are typically categorized and differentiated using rate codes in the hospitality business. Each rate code corresponds to a distinct kind of room (such as standard, deluxe, or suite) or a special price arrangement (such as non-refundable, corporate, or promotional).\n -Seasonal Pricing: Rate codes can be utilized to enforce fluctuations in pricing based on different seasons. For instance, a hotel may utilize distinct rate codes to distinguish between rates during peak season and rates during off-peak season. \n -Businesses frequently generate rate codes to facilitate special deals, packages, or promotions. These codes may encompass reductions, free perks, or combined offerings (e.g., \"bed and breakfast\" packages).\n- A business would like to have different codes per shift work.\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": "Authorization",
            "in": "header",
            "description": "Authorization token. Ex. Bearer ...",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "testMode",
            "in": "header",
            "description": "If true all responses are mocked and generated randomly.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RateCodeDto"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "RateCodeDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The value of the rate code, which serves as a unique identifier or label for specific rates associated with compensation or pricing, aiding in categorization and differentiation.",
            "nullable": true
          },
          "description": {
            "type": "string",
            "description": "The description of the rate code, providing additional context and meaning to the code, enhancing understanding and clarity regarding the purpose and significance of the rate.",
            "nullable": true
          }
        },
        "additionalProperties": {
          "type": "object",
          "nullable": true
        }
      }
    }
  }
}
```