---
title: "Get All Custom Fields"
method: GET
path: "/v2/companies/{companyId}/customfields/{category}"
tags: ["Custom Fields"]
---

# Get All Custom Fields

`GET /v2/companies/{companyId}/customfields/{category}`

## Request

- Base URL: `https://api.paylocity.com/api`
- URL: `https://api.paylocity.com/api/v2/companies/{companyId}/customfields/{category}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.paylocity.com/IdentityServer/connect/token` scopes: `WebLinkAPI`

Get All Custom Fields for the selected company

## Path parameters

- `companyId` string, required
- `category` string, required

## Response `200`

Successfully retrieved

- CustomFieldDefinition[]
  - `category` string: The custom field category.
  - `defaultValue` string: Specifies the default value of the custom field.
  - `isRequired` boolean: Indicates whether the custom field is required.
  - `label` string: The custom field label.
  - `type` string: The custom field type.
  - `values` object[]: A set of values that are applicable to the custom field.
    - `code` string: The custom field code.
    - `description` string: The custom field description.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Invalid Category
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/paylocity/apis/paylocity-api.md) - [All operations](https://skmtc.dev/paylocity/apis/paylocity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/paylocity-api/revisions/4e4bf910efae?raw)