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.

​
id
string
required
Minimum length: 1
​
type
string
required
Allowed value: "employment"
​
url
string<uri>
required
​
start
object
required
​
template
object
required

Reference to an employment-template resource.

Examples:
{
  "id": "857",
  "type": "employment-template",
  "url": "https://example.ilucca.net/lucca-api/employment-templates/857"
}
​
remoteId
string | null

Resource identifier in a third-party system.

Required string length: 1 - 200
​
employee
object

Reference to an employee resource.

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

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

Examples:
{
  "id": "123",
  "type": "legal-entity",
  "url": "https://example.ilucca.net/lucca-api/legal-entities/123"
}
​
end
object | null
​
document
object | null

Reference to a file resource.

Examples:
{
  "id": "9283sdf",
  "type": "file",
  "url": "https://example.ilucca.net/lucca-api/files/9283sdf"
}
​
createdAt
string<date-time-offset>

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

Examples:

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

​
lastUpdatedAt
string<date-time>

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

Examples:

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

​
links
object | null