Sign in

v1

latestOpenAPI 3.1.02026-07-26549156879.0 KB
EmployeeUpdates > NewHire

Reads a single New hire

This endpoint can be used to retrieve a detail of new hire employee updates.

get/api/2026-07-01/resources/employee_updates/new_hires/{id}

Path parameters

idstring required

filter by new hire incidence ids.

Response

OK

idstring required

The id of the new hire incidence

statusstring required

The status of the new hire incidence

employee_idstring required

The employee id of the new hire

first_namestring required

name of the employee.

last_namestring required

last name of the employee.

birth_namestring

The birth name of the new hire

identifierstring

national identifier number.

identifier_typestring

type of identifier (ex passport).

payroll_identifierstring

payroll identifier.

work_emailstring

personal email of the employee.

phone_numberstring

phone number of the employee.

genderstring

gender of the employee (male | female).

job_titlestring

job title of the employee.

addressstring required

address of the employee.

citystring

city of the employee.

countrystring

country code of the employee (Spain ES, United Kingdom GB).

statestring

state/province/region of the employee.

postal_codestring

postal code of the employee.

date_of_birthstring

birthday of the employee.

nationalitystring

nationality country code of the employee (Spain ES, United Kingdom GB).

start_datestring
contract_effective_datestring
contract_end_datestring
bank_accountstring

bank account number of the employee.

salary_amount_in_centsinteger

salary amount in cents.

salary_frequencystring
working_hoursinteger
working_hours_frequencystring
social_security_numberstring

social security number of the employee.

manager_idstring

manager id of the employee, you can get the manager id from employees endpoint.

tax_idstring
legal_entity_idstring

The legal entity id of the new hire

workplace_idstring

workplace id of the employee.

Example response

{
  "id": "1",
  "status": "done",
  "employee_id": "1",
  "first_name": "Ana",
  "last_name": "Blanco Perez",
  "birth_name": "John Doe",
  "identifier": "QKG587532Y",
  "identifier_type": "passport",
  "work_email": "ana@factorial.com",
  "gender": "female",
  "job_title": "Software Engineer",
  "address": "Calle Rosalía de Castro 10, 1º 1ª",
  "city": "Santander",
  "country": "ES",
  "state": "Cataluña",
  "date_of_birth": "1990-06-06",
  "nationality": "ES",
  "bank_account": "ES6220809324751871912999",
  "salary_amount_in_cents": 200000,
  "manager_id": "1",
  "legal_entity_id": "1",
  "workplace_id": "1"
}