List job-positions

GET

lucca-api

job-positions

curl --request GET \
  --url https://{host}/lucca-api/job-positions \
  --header 'Api-Version: <api-version>' \
  --header 'Authorization: Bearer <token>'

{
  "type": "job-positions",
  "url": "https://example.ilucca.net/lucca-api/job-positions?limit=10",
  "totalCount": 872,
  "items": [
    {
      "id": "74",
      "type": "job-position",
      "url": "https://example.ilucca.net/lucca-api/job-positions/74",
      "remoteId": null,
      "employment": {
        "id": "28",
        "type": "employment",
        "url": "https://example.ilucca.net/lucca-api/employments/28"
      },
      "employee": {
        "id": "416",
        "type": "employee",
        "url": "https://example.ilucca.net/lucca-api/employees/416"
      },
      "startsOn": "2024-01-01",
      "endsOn": null,
      "businessEstablishment": {
        "id": "5",
        "type": "business-establishment",
        "url": "https://example.ilucca.net/lucca-api/business-establishments/5"
      },
      "jobTitle": "Developer",
      "jobQualification": {
        "id": "982",
        "type": "job-qualification",
        "url": "https://example.ilucca.net/lucca-api/job-qualifications/982"
      },
      "manager": {
        "id": "541",
        "type": "employee",
        "url": "https://example.ilucca.net/lucca-api/employees/541"
      },
      "occupationCategory": {
        "id": "12",
        "type": "occupation-category",
        "url": "https://example.ilucca.net/lucca-api/occupation-categories/12"
      },
      "workingTimeArrangement": {
        "id": "23",
        "type": "working-time-arrangement",
        "url": "about:blank"
      },
      "department": {
        "id": "32",
        "type": "department",
        "url": "https://example.ilucca.net/lucca-api/departments/32"
      },
      "document": null,
      "notes": null,
      "changedAttributes": [
        "jobTitle",
        "jobDescription",
        "jobQualification"
      ],
      "createdAt": "2024-04-15T23:12:54.0001Z",
      "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
      "links": null
    }
  ],
  "embedded": {
    "department": {
      "32": {
        "id": "32",
        "type": "department",
        "url": "https://example.ilucca.net/lucca-api/departments/32",
        "name": "Finances",
        "remoteId": "FIN",
        "isArchived": false,
        "parent": null,
        "level": 1,
        "manager": {
          "id": "416",
          "type": "employee",
          "url": "https://example.ilucca.net/lucca-api/employees/416"
        },
        "links": {}
      }
    },
    "job-qualification": {
      "982": {
        "id": "982",
        "type": "job-qualification",
        "url": "https://example.ilucca.net/lucca-api/job-qualifications/982",
        "title": "Lead Developer",
        "profession": {
          "id": "89",
          "type": "profession",
          "url": "https://example.ilucca.net/lucca-api/professions/89"
        },
        "rank": 2,
        "createdAt": "2024-04-15T23:12:54.0001Z",
        "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
        "links": {}
      }
    },
    "employee": {
      "416": {
        "id": "416",
        "type": "employee",
        "url": "https://example.ilucca.net/lucca-api/employees/416",
        "remoteId": "00002345",
        "portrait": {
          "id": "66512232",
          "type": "portrait",
          "url": "https://example.ilucca.net/lucca-api/portraits/66512232"
        },
        "givenName": "Edward",
        "familyName": "Atkinson",
        "employeeNumber": "E000124",
        "status": "active",
        "email": "eatkinson@acme.corp",
        "birthDay": {
          "day": 22,
          "month": 12
        },
        "phoneNumber": "+33145784512",
        "applicableEmployment": {
          "id": "154",
          "type": "employment",
          "url": "https://example.ilucca.net/lucca-api/employments/154"
        },
        "applicableJobPosition": {
          "id": "74",
          "type": "job-position",
          "url": "https://example.ilucca.net/lucca-api/job-positions/74"
        },
        "createdAt": "2024-04-15T23:12:54.0001Z",
        "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
        "links": {
          "employments": {
            "href": "https://example.ilucca.net/lucca-api/employments?employee.id=416"
          },
          "jobPositions": {
            "href": "https://example.ilucca.net/lucca-api/job-positions?employment.employee.id=416"
          },
          "personalRecord": {
            "href": "https://example.ilucca.net/lucca-api/employee-personal-records?employee.id=416"
          }
        }
      }
    },
    "employment": {
      "4561": {
        "id": "4561",
        "type": "employment",
        "url": "https://example.ilucca.net/lucca-api/employments/4561",
        "remoteId": "EMPLOYMENT#4512-ac",
        "employee": {
          "id": "416",
          "type": "employee",
          "url": "https://example.ilucca.net/lucca-api/employees/416"
        },
        "legalEntity": {
          "id": "123",
          "type": "legal-entity",
          "url": "https://example.ilucca.net/lucca-api/legal-entities/123"
        },
        "start": {
          "date": "2024-01-01"
        },
        "end": null,
        "document": {
          "id": "74411",
          "type": "file",
          "url": "https://example.ilucca.net/lucca-api/files/74411"
        },
        "template": {
          "id": "4",
          "type": "employment-template",
          "url": "https://example.ilucca.net/lucca-api/employment-templates/4"
        },
        "createdAt": "2024-04-15T23:12:54.0001Z",
        "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
        "links": {
          "jobPositions": {
            "href": "https://example.ilucca.net/lucca-api/job-positions?employment.id=4561"
          },
          "trialPeriods": {
            "href": "https://example.ilucca.net/lucca-api/trial-periods?employment.id=4561"
          }
        }
      }
    }
  },
  "links": {
    "prev": null,
    "next": {
      "href": "https://example.ilucca.net/lucca-api/{resource-type}?page=!sdk87Sdh&limit=25"
    }
  }
}

Authorizations

Authorization

string

header

required

The Lucca API implements the oAuth 2 protocol with the client-credentials-flow. Refer to RFC8725.

Headers

Api-Version

enum<string>

required

Set the API version.

Available options:

2024-11-01

Example:

"2024-11-01"

If-None-Match

string

Only execute the request if current cached version of the resource does not match the one given here.

Example:

"W/q5sd4w2x1c1gfdg"

If-Match

string

Only execute the request if current cached version of the resource matches the one given here. Useful to avoid concurrency conflicts.

Example:

"W/q5sd4w2x1c1gfdg"

Accept-Encoding

string

List of compression algorithms you support.

Query Parameters

include

enum<string>[]

Include metadata:

embedded: the partial or complete representations of related resources (e.g. the employee the resource belongs to).
links: links to related resources or actions (e.g. approving a leave-request). May be null when you do not have access to the resource (or action).
totalCount: only applicable on collections (i.e. lists of resources), gives the total number of items across all pages.

Response

200

application/json

A collection of job-position resources.

type

string

required

Allowed value: "job-positions"

url

string

required

items

object[]

required

Paginated list of job-position resources.

The job position represents a stage in an employee's career during one of their employment in a given business-establishment.

It therefore outlines the attributes of the person as a professional (qualifications) and their role in the company as well as who's their manager.

items.id

string

required

Minimum length: 1

items.type

string

required

Allowed value: "job-position"

items.url

string

required

items.employment

object

required

Reference to an employment resource.

Example:

{
  "id": "354",
  "type": "employment",
  "url": "https://example.ilucca.net/lucca-api/employments/354"
}

items.startsOn

string

required

Effective date of this job-position for this employee.

Cannot be outside the range of the employment.

This should be considered "applicable" based on the related employment business-establishment timezone.

items.businessEstablishment

object

required

Reference to a business-establishment resource.

Example:

{
  "id": "5",
  "type": "business-establishment",
  "url": "https://example.ilucca.net/lucca-api/business-establishments/5"
}

items.department

object

required

Reference to a department.

Example:

{
  "id": "32",
  "type": "department",
  "url": "https://example.ilucca.net/lucca-api/departments/32"
}

items.remoteId

string | null

Resource identifier in a third-party system. No unicity constraint: two job-positions may have the same value.

items.employee

object

Read-only. Reference to the employment's employee.

items.endsOn

string | null

Read-only. End date (included) of this job-position effectiveness.

Is calculated from the startsOn property of the closest next job-position, or the endsOn date of the parent employment.

This should be considered "applicable" based on the related employment business-establishment timezone.

Must be greater or equal than StartsOn date.

items.jobTitle

string | null

Short description of the job occupied by this employee.

Maximum length: 250

items.jobQualification

object | null

Reference to a job-qualification.

Example:

{
  "id": "982",
  "type": "job-qualification",
  "url": "https://example.ilucca.net/lucca-api/job-qualifications/982"
}

items.manager

object | null

Reference to another employee, who is considered to be this employee's manager.

Example:

{
  "id": "416",
  "type": "employee",
  "url": "https://example.ilucca.net/lucca-api/employees/416"
}

items.occupationCategory

object | null

Reference to an occupation-category.

Example:

{
  "id": "443",
  "type": "occupation-category",
  "url": "https://example.ilucca.net/lucca-api/occupation-category/443"
}

items.workingTimeArrangement

object | null

Reference to a working-time-arrangement.

Example:

{
  "id": "98",
  "type": "working-time-arrangement",
  "url": "about:blank"
}

items.document

object | null

Reference to a document resource.

Example:

{
  "id": "95",
  "type": "document",
  "url": "https://example.ilucca.net/lucca-api/documents/95"
}

items.notes

string | null

Optional notes about this job-position change.

Maximum length: 500

items.changedAttributes

enum<string>[]

List of attributes that changed compared with this employee previous job-position, even if said job-position was on another employment and/or not immediately sequential.

List of attributes that can change for a job-position.

Available options:

remoteId,

jobTitle,

jobDescription,

jobQualification,

occupationCategory,

workingTimeArrangement,

department

items.t9n

object

items.t9n.jobTitle

object | null

Used for translation purposes. Object is structured as a dictionary whose keys refer to translated properties of the parent object, and whose values are a dictionary of supported languages.

On the parent object, the translated property value is considered the "invariant" translation. It is expected to show this value whenever the user's language has no translation in t9n.

Languages are identified through their RFC 4646 language tag.

items.t9n.jobDescription

object | null

Used for translation purposes. Object is structured as a dictionary whose keys refer to translated properties of the parent object, and whose values are a dictionary of supported languages.

On the parent object, the translated property value is considered the "invariant" translation. It is expected to show this value whenever the user's language has no translation in t9n.

Languages are identified through their RFC 4646 language tag.

items.createdAt

string

Read-only. UTC timestamp of the moment this object was created.

Example:

"2023-01-23T12:45:23.1234Z"

items.lastUpdatedAt

string

Read-only. UTC timestamp of the moment this object was last updated. Set upon creation, update or deletion of the object.

Example:

"2023-01-23T12:45:23.1234Z"

items.links

null

totalCount

integer | null

Total number of job-position resources across all pages that satisfy query parameters.

Required range: x >= 0

embedded

object | null

embedded.department

object | null

Dictionary of departments indexed by ID.

embedded.department.{key}

object

A department represents a subdivision of the employee workforce, most often erected around the type of activity they do.

Departments are a tree-like structure, as any department may be child to another.

Note: contrary to most resources, departments are not attached to business-establishments. This means:

business-establishments listed in access rights management do not affect departments.
employees may work in different business-establishments (or even legal-entities) and yet still belong to the same department.

embedded.department.{key}.id

string

required

Minimum length: 1

embedded.department.{key}.type

string

required

Allowed value: "department"

embedded.department.{key}.url

string

required

embedded.department.{key}.name

string

required

Required string length: 1 - 255

embedded.department.{key}.remoteId

string | null

Identifier of this object in a third-party software.

Maximum length: 255

embedded.department.{key}.isArchived

boolean

If this department is archived. Only possible if there are no more employees attached.

embedded.department.{key}.description

string | null

embedded.department.{key}.parent

object | null

Reference to the department this department is a child of.

Example:

{
  "id": "32",
  "type": "department",
  "url": "https://example.ilucca.net/lucca-api/departments/32"
}

embedded.department.{key}.level

integer

Read-only. Depth level of this department in the department tree. At level "1", the department has no parent.

Required range: x >= 1

embedded.department.{key}.manager

object | null

Reference to the employee that acts as the Head of this department.

Example:

{
  "id": "416",
  "type": "employee",
  "url": "https://example.ilucca.net/lucca-api/employees/416"
}

embedded.department.{key}.sortOrder

integer

Index (0-based) of the department among its siblings.

Required range: x >= 0

embedded.department.{key}.links

object

Example:

{
  "id": "32",
  "type": "department",
  "url": "https://example.ilucca.net/lucca-api/departments/32",
  "name": "Finances",
  "description": null,
  "remoteId": "FIN",
  "isArchived": false,
  "parent": null,
  "level": 1,
  "manager": {
    "id": "416",
    "type": "employee",
    "url": "https://example.ilucca.net/lucca-api/employees/416"
  },
  "sortOrder": 2,
  "links": {
    "activeEmployees": {
      "href": "https://example.ilucca.net/lucca-api/employees?applicableJobPosition.department.id=32"
    }
  }
}

embedded.job-qualification

object | null

Dictionary of job-qualifications indexed by ID.

embedded.job-qualification.{key}

object

A job-qualification is an object that represents an employee profile regarding their skillset.

It is composed of both:

a profession, which indicates the nature of their job.
a rank (number), which indicates either their level of expertise or of responsibilities in the company.

embedded.job-qualification.{key}.id

string

required

Minimum length: 1

embedded.job-qualification.{key}.type

string

required

Allowed value: "job-qualification"

embedded.job-qualification.{key}.url

string

required

embedded.job-qualification.{key}.title

string

required

Must be unique. Invariant name of this job-qualification. Can be translated through t9n.title[{langTag}]. Leading and trailing spaces are automatically removed.

Minimum length: 1

embedded.job-qualification.{key}.profession

object

required

Reference to a profession.

Example:

{
  "id": "89",
  "type": "profession",
  "url": "https://example.ilucca.net/lucca-api/professions/89"
}

embedded.job-qualification.{key}.rank

integer

required

The lower the rank, the "lower" in the company's hierarchy (i.e. the CEO is at max rank). Maximum rank can be set trough configuration.

Required range: x >= 1

embedded.job-qualification.{key}.t9n

object

embedded.job-qualification.{key}.createdAt

string

Read-only. UTC timestamp of the moment this object was created.

Example:

"2023-01-23T12:45:23.1234Z"

embedded.job-qualification.{key}.lastUpdatedAt

string

Read-only. UTC timestamp of the moment this object was last updated. Set upon creation, update or deletion of the object.

Example:

"2023-01-23T12:45:23.1234Z"

embedded.job-qualification.{key}.links

object | null

Example:

{
  "id": "982",
  "type": "job-qualification",
  "url": "https://example.ilucca.net/lucca-api/job-qualifications/982",
  "title": "Lead Developer",
  "profession": {
    "id": "89",
    "type": "profession",
    "url": "https://example.ilucca.net/lucca-api/professions/89"
  },
  "rank": 2,
  "createdAt": "2024-04-15T23:12:54.0001Z",
  "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
  "links": {}
}

embedded.employee

object | null

Dictionary of employees indexed by ID.

embedded.employee.{key}

object

The employee represents the public face of an employee in the system. Note that an employee can also represent a trainee, an intern, a contractor, etc...

The applicableEmployment property references the employee's employment that is:

currently in effect if the employee is "active".
will first be in effect if the employee has an employment starting in the future (either the first or a new one).
was last in effect if the employee is no longer employed and is not expected to be re-remployed in the future.

The applicableJobPosition property references the employee's job-position that matches the same logic.

embedded.employee.{key}.id

string

required

Minimum length: 1

embedded.employee.{key}.type

string

required

Allowed value: "employee"

embedded.employee.{key}.url

string

required

embedded.employee.{key}.givenName

string

required

Name given at birth. In the U.S.A., the first name of a person. In French: "prénom". Leading and trailing spaces are automatically removed.

Required string length: 1 - 100

embedded.employee.{key}.familyName

string

required

Name inherited from the person's family. In the U.S.A., the last name of a person. In French: "nom (de famille)". Leading and trailing spaces are automatically removed.

Required string length: 1 - 100

embedded.employee.{key}.email

string | null

required

Professional email of this employee. "<" and ">" characters are forbidden. Some domains are blacklisted and may thus result in 400 errors.

Required string length: 3 - 255

embedded.employee.{key}.remoteId

string | null

Must be unique.

Required string length: 1 - 100

embedded.employee.{key}.portrait

object | null

Reference to the employee's portrait, which is a file (picture) representing them.

Example:

{
  "id": "9283sdf",
  "type": "portrait",
  "url": "https://example.ilucca.net/lucca-api/portraits/9283sdf"
}

embedded.employee.{key}.employeeNumber

string | null

Minimum length: 1

embedded.employee.{key}.status

enum<string>

Read-only. The employee status is calculated from the employee's employments.

active: employee has an employment as of today.
upcoming: employee currently has no employment but will have one in the future.
deactivated: employee used to have an employment but no longer does.

Available options:

active,

upcoming,

deactivated

Example:

"active"

embedded.employee.{key}.birthDay

object | null

Year-less date of birth.

Read-only, as it is infered from the employee-personal-record birthDate. Take note that month starts at "1" and not zero, i.e. "1" is for January, "2" for February, etc...

embedded.employee.{key}.phoneNumber

string | null

Professional phone number of this employee.

Example:

"+3356565656"

embedded.employee.{key}.applicableEmployment

object

Read-only. Reference to the applicable employment of this employee. If the employee status is "deactivated", then references their last employment. If the employee status is "upcoming", then references their closest next employment.

embedded.employee.{key}.applicableJobPosition

object

Read-only. Reference to the active job-position of this employee. Matches the same logic than the "applicableEmployment".

embedded.employee.{key}.createdAt

string

Read-only. UTC timestamp of the moment this object was created.

Example:

"2023-01-23T12:45:23.1234Z"

embedded.employee.{key}.lastUpdatedAt

string

Read-only. UTC timestamp of the moment this object was last updated. Set upon creation, update or deletion of the object.

Example:

"2023-01-23T12:45:23.1234Z"

embedded.employee.{key}.links

object

Example:

{
  "id": "416",
  "type": "employee",
  "url": "https://example.ilucca.net/lucca-api/employees/416",
  "remoteId": "00002345",
  "portrait": {
    "id": "66512232",
    "type": "portrait",
    "url": "https://example.ilucca.net/lucca-api/portraits/66512232"
  },
  "givenName": "Edward",
  "familyName": "Atkinson",
  "employeeNumber": "E000124",
  "status": "active",
  "email": "eatkinson@acme.corp",
  "birthDay": { "day": 22, "month": 12 },
  "phoneNumber": "+33145784512",
  "applicableEmployment": {
    "id": "154",
    "type": "employment",
    "url": "https://example.ilucca.net/lucca-api/employments/154"
  },
  "applicableJobPosition": {
    "id": "74",
    "type": "job-position",
    "url": "https://example.ilucca.net/lucca-api/job-positions/74"
  },
  "createdAt": "2024-04-15T23:12:54.0001Z",
  "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
  "links": {
    "employments": {
      "href": "https://example.ilucca.net/lucca-api/employments?employee.id=416"
    },
    "jobPositions": {
      "href": "https://example.ilucca.net/lucca-api/job-positions?employment.employee.id=416"
    },
    "personalRecord": {
      "href": "https://example.ilucca.net/lucca-api/employee-personal-records?employee.id=416"
    }
  }
}

embedded.employment

object | null

Dictionary of employment indexed by ID.

embedded.employment.{key}

object

The employment resource represents a relationship between an employee and a legal-entity over a continuous period. It may actually represent a work contract, an internship agreement, a contractor's contract, etc...

The actual job of the employee is defined through the job-position resource, which references an employment. Over the course of his/her employment, the employee may occupy several job-positions.

embedded.employment.{key}.id

string

required

Minimum length: 1

embedded.employment.{key}.type

string

required

Allowed value: "employment"

embedded.employment.{key}.url

string

required

embedded.employment.{key}.start

object

required

embedded.employment.{key}.template

object

required

Reference to an employment-template resource.

Example:

{
  "id": "857",
  "type": "employment-template",
  "url": "https://example.ilucca.net/lucca-api/employment-templates/857"
}

embedded.employment.{key}.remoteId

string | null

Resource identifier in a third-party system.

Required string length: 1 - 200

embedded.employment.{key}.employee

object

Reference to an employee resource.

Example:

{
  "id": "416",
  "type": "employee",
  "url": "https://example.ilucca.net/lucca-api/employees/416"
}

embedded.employment.{key}.legalEntity

object

Read-only. Reference to a legal-entity. Inferred from the business-establishment of its first job-position.

Example:

{
  "id": "123",
  "type": "legal-entity",
  "url": "https://example.ilucca.net/lucca-api/legal-entities/123"
}

embedded.employment.{key}.end

object | null

embedded.employment.{key}.document

object | null

Reference to a file resource.

Example:

{
  "id": "9283sdf",
  "type": "file",
  "url": "https://example.ilucca.net/lucca-api/files/9283sdf"
}

embedded.employment.{key}.createdAt

string

Read-only. UTC timestamp of the moment this object was created.

Example:

"2023-01-23T12:45:23.1234Z"

embedded.employment.{key}.lastUpdatedAt

string

Read-only. UTC timestamp of the moment this object was last updated. Set upon creation, update or deletion of the object.

Example:

"2023-01-23T12:45:23.1234Z"

embedded.employment.{key}.links

object | null

Example:

{
  "id": "4561",
  "type": "employment",
  "url": "https://example.ilucca.net/lucca-api/employments/4561",
  "remoteId": "EMPLOYMENT#4512-ac",
  "employee": {
    "id": "416",
    "type": "employee",
    "url": "https://example.ilucca.net/lucca-api/employees/416"
  },
  "legalEntity": {
    "id": "123",
    "type": "legal-entity",
    "url": "https://example.ilucca.net/lucca-api/legal-entities/123"
  },
  "start": { "date": "2024-01-01" },
  "end": null,
  "document": {
    "id": "74411",
    "type": "file",
    "url": "https://example.ilucca.net/lucca-api/files/74411"
  },
  "template": {
    "id": "4",
    "type": "employment-template",
    "url": "https://example.ilucca.net/lucca-api/employment-templates/4"
  },
  "createdAt": "2024-04-15T23:12:54.0001Z",
  "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
  "links": {
    "jobPositions": {
      "href": "https://example.ilucca.net/lucca-api/job-positions?employment.id=4561"
    },
    "trialPeriods": {
      "href": "https://example.ilucca.net/lucca-api/trial-periods?employment.id=4561"
    }
  }
}

links

object | null

Links to related resources

Was this page helpful?

The job-position resource

Retrieve a job-position

curl --request GET \
  --url https://{host}/lucca-api/job-positions \
  --header 'Api-Version: <api-version>' \
  --header 'Authorization: Bearer <token>'

{
  "type": "job-positions",
  "url": "https://example.ilucca.net/lucca-api/job-positions?limit=10",
  "totalCount": 872,
  "items": [
    {
      "id": "74",
      "type": "job-position",
      "url": "https://example.ilucca.net/lucca-api/job-positions/74",
      "remoteId": null,
      "employment": {
        "id": "28",
        "type": "employment",
        "url": "https://example.ilucca.net/lucca-api/employments/28"
      },
      "employee": {
        "id": "416",
        "type": "employee",
        "url": "https://example.ilucca.net/lucca-api/employees/416"
      },
      "startsOn": "2024-01-01",
      "endsOn": null,
      "businessEstablishment": {
        "id": "5",
        "type": "business-establishment",
        "url": "https://example.ilucca.net/lucca-api/business-establishments/5"
      },
      "jobTitle": "Developer",
      "jobQualification": {
        "id": "982",
        "type": "job-qualification",
        "url": "https://example.ilucca.net/lucca-api/job-qualifications/982"
      },
      "manager": {
        "id": "541",
        "type": "employee",
        "url": "https://example.ilucca.net/lucca-api/employees/541"
      },
      "occupationCategory": {
        "id": "12",
        "type": "occupation-category",
        "url": "https://example.ilucca.net/lucca-api/occupation-categories/12"
      },
      "workingTimeArrangement": {
        "id": "23",
        "type": "working-time-arrangement",
        "url": "about:blank"
      },
      "department": {
        "id": "32",
        "type": "department",
        "url": "https://example.ilucca.net/lucca-api/departments/32"
      },
      "document": null,
      "notes": null,
      "changedAttributes": [
        "jobTitle",
        "jobDescription",
        "jobQualification"
      ],
      "createdAt": "2024-04-15T23:12:54.0001Z",
      "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
      "links": null
    }
  ],
  "embedded": {
    "department": {
      "32": {
        "id": "32",
        "type": "department",
        "url": "https://example.ilucca.net/lucca-api/departments/32",
        "name": "Finances",
        "remoteId": "FIN",
        "isArchived": false,
        "parent": null,
        "level": 1,
        "manager": {
          "id": "416",
          "type": "employee",
          "url": "https://example.ilucca.net/lucca-api/employees/416"
        },
        "links": {}
      }
    },
    "job-qualification": {
      "982": {
        "id": "982",
        "type": "job-qualification",
        "url": "https://example.ilucca.net/lucca-api/job-qualifications/982",
        "title": "Lead Developer",
        "profession": {
          "id": "89",
          "type": "profession",
          "url": "https://example.ilucca.net/lucca-api/professions/89"
        },
        "rank": 2,
        "createdAt": "2024-04-15T23:12:54.0001Z",
        "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
        "links": {}
      }
    },
    "employee": {
      "416": {
        "id": "416",
        "type": "employee",
        "url": "https://example.ilucca.net/lucca-api/employees/416",
        "remoteId": "00002345",
        "portrait": {
          "id": "66512232",
          "type": "portrait",
          "url": "https://example.ilucca.net/lucca-api/portraits/66512232"
        },
        "givenName": "Edward",
        "familyName": "Atkinson",
        "employeeNumber": "E000124",
        "status": "active",
        "email": "eatkinson@acme.corp",
        "birthDay": {
          "day": 22,
          "month": 12
        },
        "phoneNumber": "+33145784512",
        "applicableEmployment": {
          "id": "154",
          "type": "employment",
          "url": "https://example.ilucca.net/lucca-api/employments/154"
        },
        "applicableJobPosition": {
          "id": "74",
          "type": "job-position",
          "url": "https://example.ilucca.net/lucca-api/job-positions/74"
        },
        "createdAt": "2024-04-15T23:12:54.0001Z",
        "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
        "links": {
          "employments": {
            "href": "https://example.ilucca.net/lucca-api/employments?employee.id=416"
          },
          "jobPositions": {
            "href": "https://example.ilucca.net/lucca-api/job-positions?employment.employee.id=416"
          },
          "personalRecord": {
            "href": "https://example.ilucca.net/lucca-api/employee-personal-records?employee.id=416"
          }
        }
      }
    },
    "employment": {
      "4561": {
        "id": "4561",
        "type": "employment",
        "url": "https://example.ilucca.net/lucca-api/employments/4561",
        "remoteId": "EMPLOYMENT#4512-ac",
        "employee": {
          "id": "416",
          "type": "employee",
          "url": "https://example.ilucca.net/lucca-api/employees/416"
        },
        "legalEntity": {
          "id": "123",
          "type": "legal-entity",
          "url": "https://example.ilucca.net/lucca-api/legal-entities/123"
        },
        "start": {
          "date": "2024-01-01"
        },
        "end": null,
        "document": {
          "id": "74411",
          "type": "file",
          "url": "https://example.ilucca.net/lucca-api/files/74411"
        },
        "template": {
          "id": "4",
          "type": "employment-template",
          "url": "https://example.ilucca.net/lucca-api/employment-templates/4"
        },
        "createdAt": "2024-04-15T23:12:54.0001Z",
        "lastUpdatedAt": "2024-04-15T23:12:54.0001Z",
        "links": {
          "jobPositions": {
            "href": "https://example.ilucca.net/lucca-api/job-positions?employment.id=4561"
          },
          "trialPeriods": {
            "href": "https://example.ilucca.net/lucca-api/trial-periods?employment.id=4561"
          }
        }
      }
    }
  },
  "links": {
    "prev": null,
    "next": {
      "href": "https://example.ilucca.net/lucca-api/{resource-type}?page=!sdk87Sdh&limit=25"
    }
  }
}

Overview

Organization

Employee Records

List job-positions

Authorizations

Headers

Query Parameters

Response