---
updatedAt: 2025-06-05T21:40:28.000Z
agentTools:
  projectIndex: https://apidocs.officient.io/llms.txt
---

# Wage history

Get the entire wage history for one person

Scope required: wages:read

Refer to 'Current wage' for a list of wage types and termination reasons

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "officient-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.officient.io"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/1.0/wages/{person_id}/history": {
      "get": {
        "summary": "Wage history",
        "description": "Get the entire wage history for one person",
        "operationId": "wage-history",
        "parameters": [
          {
            "name": "person_id",
            "in": "path",
            "description": "The person you need the wage history for",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"data\": [\n    {\n      \"id\": 234252342,\n      \"start_date\": \"2017-01-15\",\n      \"end_date\": \"\",\n      \"estimated_monthly_total\": 4894,\n      \"currency\": \"EUR\",\n      \"type\": \"employee_paid_monthly\",\n      \"rate\": 3250,\n      \"created_at\": 1588595358,\n      \"updated_at\": 1588595358,\n      \"registration_country_code\": \"BE\",\n      \"estimated_monthly_cost\": {\n        \"base_components\": {\n          \"base_rate\": 3250,\n          \"social_contributions\": 885,\n          \"end_of_year_bonus\": 245.83,\n          \"retirement_plan\": 136.92,\n          \"holiday_pay\": 226.17,\n          \"hospitalization_insurance\": 0,\n          \"net_allowance\": 0,\n          \"car\": 0\n        },\n        \"custom_components\": [\n          {\n            \"description\": \"maaltijdcheques\",\n            \"monthly_value\": 149.74\n          }\n        ]\n      },\n      \"weekly_time_engagement_minutes\": {\n        \"monday\": 456,\n        \"tuesday\": 456,\n        \"wednesday\": 456,\n        \"thursday\": 456,\n        \"friday\": 456,\n        \"saturday\": 0,\n        \"sunday\": 0\n      },\n      \"custom_payroll_data\": {\n        \"contract_type\": \"internship\"\n      },\n      \"termination_reason\": \"\",\n      \"multiple_week_schedule\": null\n    },\n    {\n      \"id\": 23425231,\n      \"start_date\": \"2016-01-15\",\n      \"end_date\": \"2017-01-14\",\n      \"estimated_monthly_total\": 4594,\n      \"currency\": \"EUR\",\n      \"type\": \"employee_paid_monthly\",\n      \"rate\": 2950,\n      \"created_at\": 1586003358,\n      \"updated_at\": 1588595358,\n      \"registration_country_code\": \"BE\",\n      \"estimated_monthly_cost\": {\n        \"base_components\": {\n          \"base_rate\": 2950,\n          \"social_contributions\": 885,\n          \"end_of_year_bonus\": 245.83,\n          \"retirement_plan\": 136.92,\n          \"holiday_pay\": 226.17,\n          \"hospitalization_insurance\": 0,\n          \"net_allowance\": 0,\n          \"car\": 0\n        },\n        \"custom_components\": [\n          \n        ]\n      },\n      \"weekly_time_engagement_minutes\": {\n        \"monday\": 640,\n        \"tuesday\": 640,\n        \"wednesday\": 456,\n        \"thursday\": 456,\n        \"friday\": 456,\n        \"saturday\": 0,\n        \"sunday\": 0\n      },\n      \"custom_payroll_data\": null,\n      \"termination_reason\": \"end_of_contract\",\n      \"multiple_week_schedule\": {\n        \"schedule_start_date\": \"2016-01-15\",\n        \"weeks\": [\n          {\n            \"week_nr\": 1,\n            \"weekly_time_engagement_minutes\": {\n              \"monday\": 640,\n              \"tuesday\": 640,\n              \"wednesday\": 456,\n              \"thursday\": 456,\n              \"friday\": 456,\n              \"saturday\": 0,\n              \"sunday\": 0\n            }\n          },\n          {\n            \"week_nr\": 2,\n            \"weekly_time_engagement_minutes\": {\n              \"monday\": 0,\n              \"tuesday\": 0,\n              \"wednesday\": 456,\n              \"thursday\": 456,\n              \"friday\": 456,\n              \"saturday\": 0,\n              \"sunday\": 0\n            }\n          }\n        ]\n      },\n      \"contract_index_number\": 1\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 234252342,
                            "default": 0
                          },
                          "start_date": {
                            "type": "string",
                            "example": "2017-01-15"
                          },
                          "end_date": {
                            "type": "string",
                            "example": ""
                          },
                          "estimated_monthly_total": {
                            "type": "integer",
                            "example": 4894,
                            "default": 0
                          },
                          "currency": {
                            "type": "string",
                            "example": "EUR"
                          },
                          "type": {
                            "type": "string",
                            "example": "employee_paid_monthly"
                          },
                          "rate": {
                            "type": "integer",
                            "example": 3250,
                            "default": 0
                          },
                          "created_at": {
                            "type": "integer",
                            "example": 1588595358,
                            "default": 0
                          },
                          "updated_at": {
                            "type": "integer",
                            "example": 1588595358,
                            "default": 0
                          },
                          "registration_country_code": {
                            "type": "string",
                            "example": "BE"
                          },
                          "estimated_monthly_cost": {
                            "type": "object",
                            "properties": {
                              "base_components": {
                                "type": "object",
                                "properties": {
                                  "base_rate": {
                                    "type": "integer",
                                    "example": 3250,
                                    "default": 0
                                  },
                                  "social_contributions": {
                                    "type": "integer",
                                    "example": 885,
                                    "default": 0
                                  },
                                  "end_of_year_bonus": {
                                    "type": "number",
                                    "example": 245.83,
                                    "default": 0
                                  },
                                  "retirement_plan": {
                                    "type": "number",
                                    "example": 136.92,
                                    "default": 0
                                  },
                                  "holiday_pay": {
                                    "type": "number",
                                    "example": 226.17,
                                    "default": 0
                                  },
                                  "hospitalization_insurance": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "net_allowance": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "car": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  }
                                }
                              },
                              "custom_components": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "description": {
                                      "type": "string",
                                      "example": "maaltijdcheques"
                                    },
                                    "monthly_value": {
                                      "type": "number",
                                      "example": 149.74,
                                      "default": 0
                                    }
                                  }
                                }
                              }
                            }
                          },
                          "weekly_time_engagement_minutes": {
                            "type": "object",
                            "properties": {
                              "monday": {
                                "type": "integer",
                                "example": 456,
                                "default": 0
                              },
                              "tuesday": {
                                "type": "integer",
                                "example": 456,
                                "default": 0
                              },
                              "wednesday": {
                                "type": "integer",
                                "example": 456,
                                "default": 0
                              },
                              "thursday": {
                                "type": "integer",
                                "example": 456,
                                "default": 0
                              },
                              "friday": {
                                "type": "integer",
                                "example": 456,
                                "default": 0
                              },
                              "saturday": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              },
                              "sunday": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              }
                            }
                          },
                          "custom_payroll_data": {
                            "type": "object",
                            "properties": {
                              "contract_type": {
                                "type": "string",
                                "example": "internship"
                              }
                            }
                          },
                          "termination_reason": {
                            "type": "string",
                            "example": ""
                          },
                          "multiple_week_schedule": {}
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```