Timeoff > Policy

Reads all Policies

Changed on

Reads all Policies

get/api/2026-10-01/resources/timeoff/policies

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/timeoff/policies
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: time_off
    • or API key in header x-api-key

Query parameters

ids[]string[]

The policies ids to retrieve.

[
  "1",
  "2",
  "3"
]
company_ids[]string[]

The company ids to retrieve policies.

[
  "1",
  "2",
  "3"
]

Response

OK

Example response

{
  "data": [
    {
      "id": "1",
      "name": "Policy for remotes",
      "main": true,
      "company_id": "1",
      "description": "This policy will apply only for remote employees"
    }
  ]
}

Changes