# Recuperar métricas de empleo Recuperar métricas de empleo para un individuo. > Antes de solicitar métricas de empleo, asegúrate de realizar primero una solicitud POST Retrieve employment record details. Endpoint: POST /api/employment-metrics/ Version: 1.223.0 Security: basicAuth ## Query parameters: - `omit` (string) Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas. - `fields` (string) Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas. ## Request fields (application/json): - `link` (string, required) El para el que deseas recuperar información. Example: "c81a1dea-6dd6-4999-8b9f-541ee8197058" - `reference_date` (string) La fecha hasta la cual deseas que se calculen las métricas de empleo, en formato . Por ejemplo, si no deseas calcular las métricas de empleo para todo el 2023, agrega como . Si no proporcionas un , realizamos los cálculos hasta la fecha en que haces la solicitud. Todos los cálculos serán relativos a esta fecha. Example: "2023-03-01" - `save_data` (boolean) Indica si se debe o no persistir los datos en Belvo. Por defecto, esto está configurado en y devolvemos una respuesta 201 Created. Cuando se establece en , los datos no se persistirán y devolvemos una respuesta 200 OK. Example: true ## Response 200 fields (application/json): - `id` (string, required) Identificador único de Belvo para el elemento actual. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `link` (string,null, required) El al que pertenecen los datos. Example: "30cb4806-6e00-48a4-91c9-ca55968576c8" - `collected_at` (string, required) La marca de tiempo ISO-8601 cuando se recopiló el punto de datos. Example: "2022-02-09T08:45:50.406032Z" - `created_at` (string, required) La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo. Example: "2022-02-09T08:45:50.406032Z" - `updated_at` (string,null, required) La marca de tiempo ISO-8601 de cuándo se actualizó por última vez el cálculo de las métricas de empleo. Example: "2023-08-30T15:31:35.728607Z" - `reference_date` (string,null, required) La reference_date que proporcionaste en tu solicitud. Si no proporcionaste una, este campo devolverá , lo que indica que los cálculos se realizan hasta la fecha de la solicitud. Todos los cálculos son relativos a esta fecha. Example: "2023-06-01" - `age` (integer, required) La edad del individuo. Example: 32 - `current_status` (string, required) Indica el estado laboral del individuo. Devolvemos una de las siguientes respuestas: - - - - Enum: "EMPLOYED", "RETIRED", "UNEMPLOYED", "null" - `current_employer_count` (integer,null, required) El número de empleadores que tiene actualmente el individuo. Example: 1 - `base_salary_last` (number,null, required) El último salario base del usuario. Si es , este es el salario base actual del usuario. Example: 42.17 - `weeks_employed_last_job` (number,null, required) El número de semanas que el usuario estuvo empleado en su último trabajo. Si es , entonces este campo indica el número de semanas que el usuario ha estado empleado en su trabajo actual. Example: 327.1429 - `weeks_since_last_job` (number,null, required) El número de semanas desde su último trabajo. Si el valor de este campo es , esto indica que el usuario está actualmente empleado. - `weeks_employed_total` (number,null, required) El número total de semanas que el usuario ha estado empleado, según la institución. > > > En el caso de que el usuario esté empleado en dos o más lugares al mismo tiempo, seguimos calculando esas semanas como una semana. Por ejemplo, si un usuario tiene tres trabajos simultáneos durante un mes, esto se calcula como 4 semanas. Example: 148.2 - `weeks_with_multiple_employers` (number,null, required) El número de semanas que el individuo ha tenido más de un empleador al mismo tiempo. - `employer_count` (integer,null, required) El número total de empleadores que el usuario ha tenido. Útil para indicar la estabilidad laboral a lo largo de su vida. Example: 14 - `unique_employer_count` (integer,null, required) El número de empleadores únicos que ha tenido la persona. > > > Si el usuario dejó una empresa y regresó, por ejemplo, seis meses después a la misma empresa, esto se cuenta como un solo empleador. Example: 3 - `employers_per_year` (number,null, required) Número de empleadores por año. Útil para indicar la estabilidad laboral a lo largo de un año. > > > Si el usuario dejó una empresa y regresó, por ejemplo, seis meses después a la misma empresa, esto se cuenta como un solo empleador. Example: 0.6326 - `weeks_between_jobs` (number,null, required) El número total de semanas que el individuo estuvo desempleado. Example: 687.2865 - `max_weeks_between_jobs` (number,null, required) El número máximo de semanas que el individuo estuvo desempleado. Example: 249.8571 - `increases_last_job` (integer,null, required) El número total de aumentos salariales que el usuario tuvo en su último trabajo. Si es , esto se refiere al trabajo actual del usuario. > > > Para todos los aumentos o disminuciones salariales, solo tomamos en cuenta aquellos donde el cambio en el salario es superior al 2%. - `decreases_last_job` (integer,null, required) El número total de aumentos salariales que el usuario tuvo en su último trabajo. Si es , esto se refiere al trabajo actual del usuario. - `increases_after_change` (integer,null, required) El número total de aumentos salariales entre el penúltimo trabajo del individuo y el último (o actual) trabajo. - `decreases_after_change` (integer,null, required) El número total de disminuciones salariales entre el penúltimo trabajo del individuo y el último (o actual) trabajo. - `increases_overall` (integer,null, required) El número total de aumentos salariales a lo largo de la carrera laboral del individuo. - `decreases_overall` (integer,null, required) El número total de disminuciones salariales a lo largo de la carrera laboral del individuo. - `increases_1y` (integer,null, required) El número total de aumentos salariales a lo largo del último año del individuo (YTD). - `decreases_1y` (integer,null, required) El número total de disminuciones salariales a lo largo del último año del individuo (YTD). - `increases_3y` (integer,null, required) El número total de aumentos salariales durante los últimos tres años del individuo. > > > Si la carrera laboral del individuo es de menos de tres años, devolvemos . - `decreases_3y` (integer,null, required) El número total de disminuciones salariales a lo largo de los últimos tres años del individuo. > > > Si la carrera laboral del individuo es de menos de tres años, devolvemos . - `increases_5y` (integer,null, required) El número total de aumentos salariales durante los últimos cinco años del individuo. > > > Si la carrera laboral del individuo es de menos de cinco años, devolvemos . - `decreases_5y` (integer,null, required) El número total de disminuciones salariales a lo largo de los últimos cinco años del individuo. > > > Si la carrera laboral del individuo es de menos de cinco años, devolvemos . - `yearly_change_1y` (number,null, required) El cambio porcentual del salario del individuo para el último año (YTD). - `yearly_change_3y` (number,null, required) El cambio porcentual del salario del individuo durante los últimos tres años. > > > Si la carrera laboral del individuo es inferior a tres años, devolvemos . - `yearly_change_5y` (number,null, required) El cambio porcentual del salario del individuo durante los últimos cinco años. > > > Si la carrera laboral del individuo es inferior a cinco años, devolvemos . - `min_monthly_salary_1y` (number,null, required) El salario mensual mínimo del individuo durante el último año. Example: 3402.88 - `min_monthly_salary_3y` (number,null, required) El salario mensual mínimo del individuo durante los últimos tres años. Example: 3402.88 - `min_monthly_salary_5y` (number,null, required) El salario mensual mínimo del individuo durante los últimos cinco años. Example: 3402.88 - `average_monthly_salary_1y` (number,null, required) El salario mensual promedio del individuo durante el último año. Example: 3402.88 - `average_monthly_salary_3y` (number,null, required) El salario mensual promedio del individuo durante los últimos tres años. Example: 3402.88 - `average_monthly_salary_5y` (number,null, required) El salario mensual promedio del individuo durante los últimos cinco años. Example: 3402.88 - `max_monthly_salary_1y` (number,null, required) El salario mensual máximo del individuo para el último año. Example: 3402.88 - `max_monthly_salary_3y` (number,null, required) El salario mensual máximo del individuo durante los últimos tres años. Example: 3402.88 - `max_monthly_salary_5y` (number,null, required) El salario mensual máximo del individuo durante los últimos cinco años. Example: 3402.88 ## Response 201 fields (application/json): - `id` (string, required) Identificador único de Belvo para el elemento actual. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `link` (string,null, required) El al que pertenecen los datos. Example: "30cb4806-6e00-48a4-91c9-ca55968576c8" - `collected_at` (string, required) La marca de tiempo ISO-8601 cuando se recopiló el punto de datos. Example: "2022-02-09T08:45:50.406032Z" - `created_at` (string, required) La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo. Example: "2022-02-09T08:45:50.406032Z" - `updated_at` (string,null, required) La marca de tiempo ISO-8601 de cuándo se actualizó por última vez el cálculo de las métricas de empleo. Example: "2023-08-30T15:31:35.728607Z" - `reference_date` (string,null, required) La reference_date que proporcionaste en tu solicitud. Si no proporcionaste una, este campo devolverá , lo que indica que los cálculos se realizan hasta la fecha de la solicitud. Todos los cálculos son relativos a esta fecha. Example: "2023-06-01" - `age` (integer, required) La edad del individuo. Example: 32 - `current_status` (string, required) Indica el estado laboral del individuo. Devolvemos una de las siguientes respuestas: - - - - Enum: "EMPLOYED", "RETIRED", "UNEMPLOYED", "null" - `current_employer_count` (integer,null, required) El número de empleadores que tiene actualmente el individuo. Example: 1 - `base_salary_last` (number,null, required) El último salario base del usuario. Si es , este es el salario base actual del usuario. Example: 42.17 - `weeks_employed_last_job` (number,null, required) El número de semanas que el usuario estuvo empleado en su último trabajo. Si es , entonces este campo indica el número de semanas que el usuario ha estado empleado en su trabajo actual. Example: 327.1429 - `weeks_since_last_job` (number,null, required) El número de semanas desde su último trabajo. Si el valor de este campo es , esto indica que el usuario está actualmente empleado. - `weeks_employed_total` (number,null, required) El número total de semanas que el usuario ha estado empleado, según la institución. > > > En el caso de que el usuario esté empleado en dos o más lugares al mismo tiempo, seguimos calculando esas semanas como una semana. Por ejemplo, si un usuario tiene tres trabajos simultáneos durante un mes, esto se calcula como 4 semanas. Example: 148.2 - `weeks_with_multiple_employers` (number,null, required) El número de semanas que el individuo ha tenido más de un empleador al mismo tiempo. - `employer_count` (integer,null, required) El número total de empleadores que el usuario ha tenido. Útil para indicar la estabilidad laboral a lo largo de su vida. Example: 14 - `unique_employer_count` (integer,null, required) El número de empleadores únicos que ha tenido la persona. > > > Si el usuario dejó una empresa y regresó, por ejemplo, seis meses después a la misma empresa, esto se cuenta como un solo empleador. Example: 3 - `employers_per_year` (number,null, required) Número de empleadores por año. Útil para indicar la estabilidad laboral a lo largo de un año. > > > Si el usuario dejó una empresa y regresó, por ejemplo, seis meses después a la misma empresa, esto se cuenta como un solo empleador. Example: 0.6326 - `weeks_between_jobs` (number,null, required) El número total de semanas que el individuo estuvo desempleado. Example: 687.2865 - `max_weeks_between_jobs` (number,null, required) El número máximo de semanas que el individuo estuvo desempleado. Example: 249.8571 - `increases_last_job` (integer,null, required) El número total de aumentos salariales que el usuario tuvo en su último trabajo. Si es , esto se refiere al trabajo actual del usuario. > > > Para todos los aumentos o disminuciones salariales, solo tomamos en cuenta aquellos donde el cambio en el salario es superior al 2%. - `decreases_last_job` (integer,null, required) El número total de aumentos salariales que el usuario tuvo en su último trabajo. Si es , esto se refiere al trabajo actual del usuario. - `increases_after_change` (integer,null, required) El número total de aumentos salariales entre el penúltimo trabajo del individuo y el último (o actual) trabajo. - `decreases_after_change` (integer,null, required) El número total de disminuciones salariales entre el penúltimo trabajo del individuo y el último (o actual) trabajo. - `increases_overall` (integer,null, required) El número total de aumentos salariales a lo largo de la carrera laboral del individuo. - `decreases_overall` (integer,null, required) El número total de disminuciones salariales a lo largo de la carrera laboral del individuo. - `increases_1y` (integer,null, required) El número total de aumentos salariales a lo largo del último año del individuo (YTD). - `decreases_1y` (integer,null, required) El número total de disminuciones salariales a lo largo del último año del individuo (YTD). - `increases_3y` (integer,null, required) El número total de aumentos salariales durante los últimos tres años del individuo. > > > Si la carrera laboral del individuo es de menos de tres años, devolvemos . - `decreases_3y` (integer,null, required) El número total de disminuciones salariales a lo largo de los últimos tres años del individuo. > > > Si la carrera laboral del individuo es de menos de tres años, devolvemos . - `increases_5y` (integer,null, required) El número total de aumentos salariales durante los últimos cinco años del individuo. > > > Si la carrera laboral del individuo es de menos de cinco años, devolvemos . - `decreases_5y` (integer,null, required) El número total de disminuciones salariales a lo largo de los últimos cinco años del individuo. > > > Si la carrera laboral del individuo es de menos de cinco años, devolvemos . - `yearly_change_1y` (number,null, required) El cambio porcentual del salario del individuo para el último año (YTD). - `yearly_change_3y` (number,null, required) El cambio porcentual del salario del individuo durante los últimos tres años. > > > Si la carrera laboral del individuo es inferior a tres años, devolvemos . - `yearly_change_5y` (number,null, required) El cambio porcentual del salario del individuo durante los últimos cinco años. > > > Si la carrera laboral del individuo es inferior a cinco años, devolvemos . - `min_monthly_salary_1y` (number,null, required) El salario mensual mínimo del individuo durante el último año. Example: 3402.88 - `min_monthly_salary_3y` (number,null, required) El salario mensual mínimo del individuo durante los últimos tres años. Example: 3402.88 - `min_monthly_salary_5y` (number,null, required) El salario mensual mínimo del individuo durante los últimos cinco años. Example: 3402.88 - `average_monthly_salary_1y` (number,null, required) El salario mensual promedio del individuo durante el último año. Example: 3402.88 - `average_monthly_salary_3y` (number,null, required) El salario mensual promedio del individuo durante los últimos tres años. Example: 3402.88 - `average_monthly_salary_5y` (number,null, required) El salario mensual promedio del individuo durante los últimos cinco años. Example: 3402.88 - `max_monthly_salary_1y` (number,null, required) El salario mensual máximo del individuo para el último año. Example: 3402.88 - `max_monthly_salary_3y` (number,null, required) El salario mensual máximo del individuo durante los últimos tres años. Example: 3402.88 - `max_monthly_salary_5y` (number,null, required) El salario mensual máximo del individuo durante los últimos cinco años. Example: 3402.88 ## Response 403 fields (application/json): - `code` (string) Un código de error único () que te permite clasificar y manejar el error de manera programática. ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied. Example: "access_to_resource_denied" - `message` (string) Una breve descripción del error. Para los errores , la descripción es: - . Example: "You don't have access to this resource." - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 404 fields (application/json): - `code` (string) Un código de error único () que te permite clasificar y manejar el error de manera programática. Example: "not_found" - `message` (string) Una breve descripción del error. Para errores , la descripción es: - Example: "Not found" - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 408 fields (application/json): - `code` (string) Un código de error único () que te permite clasificar y manejar el error de manera programática. ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout. Example: "request_timeout" - `message` (string) Una breve descripción del error. Para los errores de , la descripción es: - . Example: "The request timed out, you can retry asking for less data by changing your query parameters" - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 500 fields (application/json): - `code` (string) Un código de error único () que te permite clasificar y manejar el error de manera programática. ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error. Example: "unexpected_error" - `message` (string) Una breve descripción del error. Para los errores , la descripción es: - . Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution" - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb"