v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB

Contracts > ContractVersion

Reads all Contract versions

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

Query parameters

ids[]string[]

list of contract version identifiers.

[
  "1",
  "2"
]

employee_ids[]string[]

list of employee identifiers, refers to /employees/employees endpoint.

[
  "1",
  "2"
]

datestring

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

Example:2024-10-06

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

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

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

updated_at_lteqstring

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

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

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

Response

Example response

{
  "data": [
    {
      "id": "1",
      "company_id": "1",
      "employee_id": "1",
      "effective_on": "2024-10-06",
      "country": "es",
      "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_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"
            }
          ]
        }
      },
      "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"
    }
  ]
}