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

# Get Work Locations

**Summary Description**

The GET Work Location list by Company ID endpoint allows users to fetch a list of work location details from a client's Paylocity instance. Work locations, referred to as geographic or location codes, serve as designations employed by corporations to specify particular physical or geographic places where their personnel are stationed. These codes fulfill several crucial functions in the domains of human resources, operations, and management. To use this endpoint, the Paylocity Company ID and “workLocations” parameter must be specified.

**Use Cases**

- Locations are addresses used as work or hiring locations. Each worker should have an assigned work location. The purpose of a work location is to verify workers' taxes. Work locations in HR & Payroll will show in Paylocity's Recruiting platform when creating job postings.
- This information will also transfer to external job sites if using Recruiting Enhanced Features. Currently, only one work location can be added to each job listing.


# 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}/workLocations": {
      "get": {
        "tags": [
          "Payroll/HR"
        ],
        "summary": "Get Work Locations",
        "description": "**Summary Description**\n\nThe GET Work Location list by Company ID endpoint allows users to fetch a list of work location details from a client's Paylocity instance. Work locations, referred to as geographic or location codes, serve as designations employed by corporations to specify particular physical or geographic places where their personnel are stationed. These codes fulfill several crucial functions in the domains of human resources, operations, and management. To use this endpoint, the Paylocity Company ID and “workLocations” parameter must be specified.\n\n**Use Cases**\n\n- Locations are addresses used as work or hiring locations. Each worker should have an assigned work location. The purpose of a work location is to verify workers' taxes. Work locations in HR & Payroll will show in Paylocity's Recruiting platform when creating job postings.\n- This information will also transfer to external job sites if using Recruiting Enhanced Features. Currently, only one work location can be added to each job listing.\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/WorkLocationDto"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "WorkLocationDto": {
        "type": "object",
        "properties": {
          "workLocationId": {
            "type": "string",
            "description": "The unique identifier associated with the work location, used for internal reference and identification purposes.",
            "nullable": true
          },
          "companyId": {
            "type": "string",
            "description": "The identifier of the company to which this work location belongs, serving as a reference to the specific payroll entity.",
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "The name or label assigned to the work location, providing a human-readable identifier for easy recognition.",
            "nullable": true
          },
          "address1": {
            "type": "string",
            "description": "The first line of the physical address associated with the work location, specifying the primary point of contact.",
            "nullable": true
          },
          "address2": {
            "type": "string",
            "description": "The second line of the physical address associated with the work location, specifying the primary point of contact.",
            "nullable": true
          },
          "city": {
            "type": "string",
            "description": "The city or locality where the work location is situated, enhancing geographical identification.",
            "nullable": true
          },
          "state": {
            "type": "string",
            "description": "The state or administrative region in which the work location is located, contributing to precise regional categorization.",
            "nullable": true
          },
          "zip": {
            "type": "string",
            "description": "The ZIP code associated with the work location, facilitating postal and logistical processes and ensuring accurate addressing.",
            "nullable": true
          },
          "county": {
            "type": "string",
            "description": "The country code representing the country in which the work location is situated, aiding in international categorization and geographical reference.",
            "nullable": true
          },
          "countryCode": {
            "type": "string",
            "description": "The country code for the work location.",
            "nullable": true
          },
          "defaultCurrencyCode": {
            "type": "string",
            "description": "The default currency code for the work location.",
            "nullable": true
          }
        },
        "additionalProperties": {
          "type": "object",
          "nullable": true
        }
      }
    }
  }
}
```