Employment

A worker's employment information contains information about his or her income and work history. You can access it by making a GET to /accounts/:account_id/employment .

employment_info

Data	Description	Type	Example
id_type	Identification type	string	curp
federal_entity	Entity in which you are working	string	MEXICO CITY
quoted_days	Quoted days	int	31
quoted_weeks	Quoted weeks	int	10
discounted_weeks	Discounted weeks	int	1
reintegrated_weeks	Reintegrated weeks	int	0
status	Employment status	string	active

employment_history

Data	Description	Type	Example
employer	Employer name	string	COMPANY SA DE CV
employer_registration	Employer registration	string	C412852010
start_date	Start date	date	2022-04-01
end_date	End date	date	2022-08-01
base_salary	Daily salary	float	13000.13
monthly_salary	Monthly salary	float	13000.13
payment_frequency	Payment frequency	string	monthly
payment_days	Paydays	string	30
job_title	Position	string	Software Engineer
designation	Designación	string	Base
modality	Modalidad	string	All benefits

employment_events

Data	Description	Type	Example
event_type	Event type	string	salary_modification
event_date	Event date	date	2022-04-01
event_end_date	Event end date	date	2022-04-30
base_salary	Base contribution salary	float	13000.13

Incomes (Carteira de Trabalho only)

Data	Description	Type	Example
amount	Amount	float	1346.58
currency	Currency	string	brl
income_date	Day to which the profits correspond	date	2022-04-01T00:00:00+00:00

Data we recover by platform

The following table shows the data we recover for the main platforms:

DATA	Type	Description	IMSS	ISSSTE	Carteira de Trabalho
account_id	string	Palenca internal identifier of the employee account	YES	YES	YES
id_type	string	Type of identification within the platform (e.g. social security number, curp)	YES	YES	YES
quoted_weeks	int	Number of weeks contributed to the IMSS since the employee began his or her working life	YES	NO	NO
discounted_weeks	int	Number of weeks discounted to the IMSS	YES	NO	NO
reintegrated_weeks	int	Number of weeks reintegrated to the IMSS	YES	NO	NO
end_of_rights	string	Date on which the employee stopped enjoying rights before the IMSS. If you still have rights, the value is shown as null.	YES	NO	NO
status	string	Current situation of the employee	YES	YES	NO
employer	string	Company name of the employer (can be repeated when the salary changes, another record or contracts are generated and leave is generated with the same one)	YES	YES	YES
employer_registration	string	Employer registration number for social security.	YES	NO	NO
start_date	string	Date on which the employee began working for the employer. Comes in format YYYY-MM-DD	YES	YES	YES
end_date	string	Date on which the employee stopped working for the employer. It comes in YYYY-MM-DD format. If the employee is still registered with that employer, the value will come as null	YES	YES	YES
federal_entity	string	Federal entity in which the employer is registered. For ISSSTE it can come as null	YES	NO	YES
base_salary	float	IMSS Base Salary	YES	NO	NO
monthly_salary	float	It is the monthly salary rounded to 2 decimal places.	YES	YES	NO
net_monthly_salary	float	It is the net monthly salary rounded to 2 decimal places.	NO	NO	YES
gross_monthly_salary	float	It is the gross monthly salary rounded to 2 decimal places.	NO	NO	YES