The employee-personal-record resource represents the confidential attributes of an employee, i.e. sensitive personal information about them which gives details of their background, identity proofs, and qualifications.

id
string
required
Minimum length: 1
type
string
required
Allowed value: "employee-personal-record"
url
string<uri>
required
employee
object
required

Reference to an employee resource. Only one employee-personal-record per employee.

Examples:
{
"id": "416",
"type": "employee",
"url": "https://example.ilucca.net/lucca-api/employees/416"
}
title
enum<string>
  • unknown: Not indicated. Equivalent to a technical null.
  • mister: Either married or unmarried man. French: 'Monsieur'.
  • miss: Unmarried woman. French: 'Mademoiselle'.
Available options:
unknown,
mister,
miss

"Unknown" is equivalent to "unspecified" or "null".

"Diverse" may be legally acknowledged in some countries (e.g. Germany).

Available options:
unknown,
male,
female,
diverse
Examples:

"unknown"

birthDate
string<date> | null

YYYY-MM-DD formatted date of birth.

insuranceNumber
object | null

Validation depends on selected format. Value for "other" format is not validated.

nationalitiesCountryCodes
enum<string>[]

Array of ISO 3166-1 alpha-3 country codes.

Maximum length: 1
bankAccount
object | null

Represents a bank account in any format, including IBAN, SWIFT, and region-specific routing details.

Examples:
{
"format": "iban",
"bankName": "BNP Paribas",
"accountIdentifier": "FR7630006000011234567890189",
"bankIdentifier": null
}
{
"format": "other",
"bankName": "JPMorgan Chase Bank",
"accountNumber": "123456789",
"routingNumber": "021000021"
}
phoneNumber
string<phone>

Phone number.

Examples:

"+3356565656"

email
string<email> | null

Personal email address of the employee.