Security: OAuth 2.0
Security: OAuth 2.0
employee-personal-records.readonly
employee-personal-records.readwrite
Authorizations
The Lucca API implements the oAuth 2 protocol with the client-credentials-flow. Refer to RFC8725.
Headers
Only execute the request if current cached version of the resource does not match the one given here.
"W/q5sd4w2x1c1gfdg"
Only execute the request if current cached version of the resource matches the one given here. Useful to avoid concurrency conflicts.
"W/q5sd4w2x1c1gfdg"
List of compression algorithms you support.
Path Parameters
Identifier of the employee-personal-record to retrieve.
Query Parameters
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 benull
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.
Read more about expanding responses.
Response
OK
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. Embedded resources on a employee-personal-record(s) response. An employee-personal-record resource.
1
"employee-personal-record"
Reference to an employee resource. Only one employee-personal-record per employee.
{
"id": "416",
"type": "employee",
"url": "https://example.ilucca.net/lucca-api/employees/416"
}
unknown
: Not indicated. Equivalent to a technicalnull
.mister
: Either married or unmarried man. French: 'Monsieur'.miss
: Unmarried woman. French: 'Mademoiselle'.
unknown
, mister
, miss
"Unknown" is equivalent to "unspecified" or "null".
"Diverse" may be legally acknowledged in some countries (e.g. Germany).
unknown
, male
, female
, diverse
"unknown"
YYYY-MM-DD formatted date of birth.
Validation depends on selected format. Value for "other" format is not validated.
Array of ISO 3166-1 alpha-3 country codes.
1
Represents a bank account in any format, including IBAN, SWIFT, and region-specific routing details.
{
"format": "iban",
"bankName": "BNP Paribas",
"accountIdentifier": "FR7630006000011234567890189",
"bankIdentifier": null
}
{
"format": "other",
"bankName": "JPMorgan Chase Bank",
"accountNumber": "123456789",
"routingNumber": "021000021"
}
Phone number.
"+3356565656"
Personal email address of the employee.