FAfactorialhr
Contracts > ContractVersion

Reads all Contract versions

Changed on

Reads all Contract versions

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

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/contracts/contract_versions
  • 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

ids[]string[]

Return only the contract versions with these ids.

[
  "1",
  "2"
]
employee_ids[]string[]

Return only the contract versions of these employees.

[
  "1",
  "2"
]
datestring

filters contracts of employees with effective_on date less or equal than the given date.

Example:2024-10-06
job_catalog_tree_node_uuids[]string[] required

the uuid of nodes in the job catalog tree. As only level nodes are accepted and persisted, so filtering with other node types will return no results. Refer to job_catalog/tree_nodes endpoint.

[
  "jobcatalog_treelevel-14",
  "jobcatalog_treelevel-15"
]
updated_at_gteqstring

Filter contract versions updated on or after this timestamp (ISO 8601).

Example:2024-01-01T00:00:00.000Z
updated_at_lteqstring

Filter contract versions updated on or before this timestamp (ISO 8601).

Example:2024-12-31T23:59:59.999Z

Response

OK

Example response

{
  "data": [
    {
      "id": "1",
      "company_id": "1",
      "employee_id": "1",
      "effective_on": "2024-10-06",
      "country": "es",
      "contracts_contract_id": "1",
      "job_title": "Designer",
      "job_catalog_level_id": "1",
      "job_catalog_tree_node_uuid": "jobcatalog_treelevel-14",
      "starts_on": "2024-10-06",
      "ends_on": "2024-10-06",
      "trial_period_ends_on": "2024-10-06",
      "salary_amount": 1000,
      "salary_currency": "EUR",
      "salary_frequency": "yearly",
      "working_week_days": "monday,tuesday,wednesday,thursday,friday",
      "working_hours": 40,
      "working_hours_frequency": "week",
      "max_legal_yearly_hours": 2000,
      "maximum_weekly_hours": 40,
      "bank_holiday_treatment": "workable",
      "working_time_percentage_in_cents": 8000,
      "annual_working_time_distribution": "limit_workdays",
      "version_data": {
        "country_data": {
          "country": "es",
          "fields": [
            {
              "name": "contract_type",
              "field_name": "Tipo de contrato",
              "value_label": "Indefinido",
              "value_id": "1"
            },
            {
              "name": "working_hours",
              "field_name": "working_hours",
              "value_label": "40",
              "value_id": "40"
            }
          ],
          "template_fragments": {
            "company_fragment_id": "1",
            "country_fragment_id": "2",
            "legal_entity_fragment_id": "3"
          }
        }
      },
      "min_rest_minutes_between_days": 2880,
      "max_work_minutes_per_day": 480,
      "max_work_days_in_row": 6,
      "min_rest_hours_in_row": 36,
      "created_at": "2024-10-06T00:00:00.000Z",
      "updated_at": "2024-10-06T00:00:00.000Z",
      "es_cotization_group": 1,
      "contracts_es_tariff_group_id": "1",
      "es_contract_observations": "review contract for job promotion",
      "es_job_description": "Designer",
      "es_contract_type_id": "1",
      "es_working_day_type_id": "1",
      "es_education_level_id": "1",
      "es_professional_category_id": "1",
      "fr_employee_type": "apprenti",
      "fr_jours_par_an": 200,
      "fr_coefficient": "1",
      "fr_contract_type_id": "1",
      "fr_level_id": "1",
      "fr_step_id": "1",
      "fr_mutual_id": "1",
      "fr_professional_category_id": "1",
      "fr_work_type_id": "1",
      "de_contract_type_id": "1",
      "de_base_salary_type_id": "1",
      "pt_contract_type_id": "1"
    }
  ]
}

Changes