List Employee Jobs

---

GET /services/api/v1/employee_jobs

Returns a list of employees jobs.

Optional Query Parameters

Parameter	Type	Description
employee_id	string	Only return employee jobs that belong to the specified employee.
created_at_since	timestamp	Only return employee jobs that have been created since the specified timestamp.
updated_at_since	timestamp	Only return employee jobs that have been updated since the specified timestamp.

Response

200

Results list.

Example

{
  "entries": [
    {
      "id": "7bBJADz2",
      "employee_id": "rQ6ZV6W5",
      "from": "2024-08-25",
      "to": "2024-12-18",
      "notes": null,
      "time_percentage": 60.0,
      "time_hours": 25.0,
      "time_type": "part_time",
      "time_table": null,
      "classification": null,
      "job_type": "unlimited",
      "supervisor_id": "KRBbJBwN",
      "department_id": "rQ6ZV6W5",
      "location_id": "KRBbJBwN",
      "name": "Regional Manager",
      "created_at": "2024-10-10T13:43:56.347Z",
      "updated_at": "2024-10-14T10:06:50.112Z"
    },
    {
      "id": "AmYlkGBD",
      "employee_id": "52B4yOY0",
      "from": "2024-10-10",
      "to": null,
      "notes": null,
      "time_percentage": 100.0,
      "time_hours": 40.0,
      "time_type": "unknown",
      "time_table": null,
      "classification": null,
      "job_type": "unknown",
      "supervisor_id": "x4Yk2pBm",
      "department_id": "Rq6DRBm3",
      "location_id": "RrB7LYD2",
      "name": "Assistant to the regional manager",
      "created_at": "2024-10-10T13:40:33.120Z",
      "updated_at": "2024-10-14T14:19:46.272Z"
    }
  ],
  "current_page": 1,
  "per_page": 30,
  "total_entries": 2
}

Schema

Attribute	Type	Required	Description
id	string	readonly	Id of the employee job.
created_at	datetime	readonly	Employee job creation date.
updated_at	datetime	readonly	Employee job last updated at.
name	string	true	Name of the employee job. Usually the job title.
employee_id	string	true	Id of the employee the job belongs to.
from	date	true	Start date of the employee job (ISO8601).
to	date	false	End date of the employee job (ISO8601). Null if unlimited.

Note that the fields above are only the fixed fields. All custom fields are provided by the Employee Job Fields API endpoint.