FAfactorialhr
Contracts > ContractActivityPeriod

List the activity periods of a contract.

Changed on

Returns the activity and inactivity periods of a single contract, most recent first. Periods are derived from the contract's approved versions, so they reflect the contract as it stands today. A contract that does not exist, or that the caller is not allowed to see, returns an empty list.

get/api/2026-10-01/resources/contracts/contract_activity_periods

Request

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

Query parameters

contract_idstring required

The contract whose periods are returned. Required — periods are computed per contract rather than stored, so they cannot be listed across a company.

Example:1

Response

OK

Example response

{
  "data": [
    {
      "id": "1_2024-07-17",
      "contract_id": "1",
      "employee_id": "1",
      "type": "activity",
      "activity_period_starts_on": "2024-07-17",
      "activity_period_ends_on": "2024-12-31"
    }
  ]
}

Changes