v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB

Contracts > ReferenceContract

Reads all Reference contracts

Reads all Reference Contracts. The reference contract is the contract that applies today. If no contract applies today, we will return the nearest upcoming contract. If there are no upcoming contracts, we will provide the most recent past contract.

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

Query parameters

employee_ids[]string[]

filter by employee ids.

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

job_catalog_tree_node_uuids[]string[] required

the uuid of nodes in the job catalog tree.

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

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"
    }
  ]
}