GET /rest/v1.0/workforce-planning/v2/companies/{company_id}/people/{person_id}/time-off

Retrieves all Time Off entries for a specified Person within a company.

Servers

Path parameters

Name Type Required Description
person_id Integer Yes

Unique identifier for the person

company_id Yes

Unique identifier for the company. This parameter accepts both formats:

  • Recommended: Procore company ID (integer) - Use this for new integrations
  • Legacy: LaborChart UUID format (uuid string) - Supported for backward compatibility

A proxy layer automatically handles both formats, but using the Procore company ID is preferred for consistency with other Procore APIs.

Request headers

Name Type Required Description
Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Query parameters

Name Type Required Description
timezone String Yes

The timezone in which to order time off entries.

limit Integer No

The number of time off records to be returned in a single request. Default is 40.

start_after String No

Time off ID used for pagination.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.