# Recuperar métricas de emprego Recuperar métricas de emprego para um indivíduo. > Antes de solicitar métricas de emprego, certifique-se de primeiro fazer uma solicitação POST Retrieve employment record details. Endpoint: POST /api/employment-metrics/ Version: 1.223.0 Security: basicAuth ## Query parameters: - `omit` (string) Omitir certos campos de serem retornados na resposta. Para mais informações, consulte nosso artigo Filtrando respostas no DevPortal. - `fields` (string) Retorne apenas os campos especificados na resposta. Para mais informações, consulte nosso artigo no DevPortal Filtrando respostas. ## Request fields (application/json): - `link` (string, required) O para o qual você deseja recuperar informações. Example: "c81a1dea-6dd6-4999-8b9f-541ee8197058" - `reference_date` (string) A data até a qual você deseja que as métricas de emprego sejam calculadas, no formato . Por exemplo, se você não quiser calcular as métricas de emprego para todo o ano de 2023, adicione como o . Se você não fornecer um , realizaremos os cálculos até a data em que você fizer a solicitação. Todos os cálculos serão relativos a esta data. Example: "2023-03-01" - `save_data` (boolean) Indica se os dados devem ou não ser persistidos no Belvo. Por padrão, isso é definido como e retornamos uma resposta 201 Created. Quando definido como , os dados não serão persistidos e retornamos uma resposta 200 OK. Example: true ## Response 200 fields (application/json): - `id` (string, required) Identificador único da Belvo para o item atual. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `link` (string,null, required) O ao qual os dados pertencem. Example: "30cb4806-6e00-48a4-91c9-ca55968576c8" - `collected_at` (string, required) O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado. Example: "2022-02-09T08:45:50.406032Z" - `created_at` (string, required) O carimbo de data e hora ISO-8601 de quando o ponto de dados foi criado no banco de dados da Belvo. Example: "2022-02-09T08:45:50.406032Z" - `updated_at` (string,null, required) O carimbo de data/hora ISO-8601 de quando o cálculo das métricas de emprego foi atualizado pela última vez. Example: "2023-08-30T15:31:35.728607Z" - `reference_date` (string,null, required) A reference_date que você forneceu em sua solicitação. Se você não forneceu uma, este campo retornará , indicando que os cálculos são realizados até a data da solicitação. Todos os cálculos são relativos a esta data. Example: "2023-06-01" - `age` (integer, required) A idade do indivíduo. Example: 32 - `current_status` (string, required) Indica o status de emprego do indivíduo. Retornamos uma das seguintes respostas: - - - - Enum: "EMPLOYED", "RETIRED", "UNEMPLOYED", "null" - `current_employer_count` (integer,null, required) O número de empregadores que o indivíduo tem no momento. Example: 1 - `base_salary_last` (number,null, required) O salário base mais recente do usuário. Se for , este é o salário base atual do usuário. Example: 42.17 - `weeks_employed_last_job` (number,null, required) O número de semanas em que o usuário esteve empregado em seu último emprego. Se for , então este campo indica o número de semanas em que o usuário está empregado em seu emprego atual. Example: 327.1429 - `weeks_since_last_job` (number,null, required) O número de semanas desde o último emprego. Se o valor deste campo for , isso indica que o usuário está atualmente empregado. - `weeks_employed_total` (number,null, required) O número total de semanas em que o usuário esteve empregado, de acordo com a instituição. > > > No caso de o usuário estar empregado em dois ou mais lugares ao mesmo tempo, ainda calculamos essas semanas como uma semana. Por exemplo, se um usuário tem três empregos simultâneos por um mês, isso é calculado como 4 semanas. Example: 148.2 - `weeks_with_multiple_employers` (number,null, required) O número de semanas em que o indivíduo teve mais de um empregador ao mesmo tempo. - `employer_count` (integer,null, required) O número total de empregadores que o usuário teve. Útil para indicar a estabilidade de emprego ao longo de sua vida. Example: 14 - `unique_employer_count` (integer,null, required) O número de empregadores únicos que o indivíduo teve. > > > Se o usuário saiu de uma empresa e retornou, por exemplo, seis meses depois para a mesma empresa, isso é contado como um empregador. Example: 3 - `employers_per_year` (number,null, required) Número de empregadores por ano. Útil para indicar a estabilidade no emprego ao longo de um ano. > > > Se o usuário saiu de uma empresa e retornou, por exemplo, seis meses depois para a mesma empresa, isso é contado como um empregador. Example: 0.6326 - `weeks_between_jobs` (number,null, required) O número total de semanas em que o indivíduo esteve desempregado. Example: 687.2865 - `max_weeks_between_jobs` (number,null, required) O número máximo de semanas em que o indivíduo esteve desempregado. Example: 249.8571 - `increases_last_job` (integer,null, required) O número total de aumentos salariais que o usuário teve em seu último emprego. Se for , isso se refere ao emprego atual do usuário. > > > Para todos os aumentos ou reduções salariais, consideramos apenas aqueles em que a mudança no salário é superior a 2%. - `decreases_last_job` (integer,null, required) O número total de aumentos salariais que o usuário teve em seu último emprego. Se for , isso se refere ao emprego atual do usuário. - `increases_after_change` (integer,null, required) O número total de aumentos salariais entre o penúltimo emprego do indivíduo e o último (ou atual) emprego. - `decreases_after_change` (integer,null, required) O número total de reduções salariais entre o penúltimo emprego do indivíduo e o último (ou atual) emprego. - `increases_overall` (integer,null, required) O número total de aumentos salariais ao longo da carreira profissional do indivíduo. - `decreases_overall` (integer,null, required) O número total de reduções salariais ao longo da carreira profissional do indivíduo. - `increases_1y` (integer,null, required) O número total de aumentos salariais ao longo do último ano do indivíduo (YTD). - `decreases_1y` (integer,null, required) O número total de reduções salariais ao longo do último ano do indivíduo (YTD). - `increases_3y` (integer,null, required) O número total de aumentos salariais ao longo dos últimos três anos do indivíduo. > > > Se a carreira profissional do indivíduo for inferior a três anos, retornamos . - `decreases_3y` (integer,null, required) O número total de reduções salariais ao longo dos últimos três anos do indivíduo. > > > Se a carreira profissional do indivíduo for inferior a três anos, retornamos . - `increases_5y` (integer,null, required) O número total de aumentos salariais ao longo dos últimos cinco anos do indivíduo. > > > Se a carreira profissional do indivíduo for inferior a cinco anos, retornamos . - `decreases_5y` (integer,null, required) O número total de reduções salariais ao longo dos últimos cinco anos do indivíduo. > > > Se a carreira profissional do indivíduo for inferior a cinco anos, retornamos . - `yearly_change_1y` (number,null, required) A mudança percentual do salário do indivíduo para o último ano (YTD). - `yearly_change_3y` (number,null, required) A variação percentual do salário do indivíduo nos últimos três anos. > > > Se a carreira profissional do indivíduo for inferior a três anos, retornamos . - `yearly_change_5y` (number,null, required) A variação percentual do salário do indivíduo nos últimos cinco anos. > > > Se a carreira profissional do indivíduo for inferior a cinco anos, retornamos . - `min_monthly_salary_1y` (number,null, required) O salário mensal mínimo do indivíduo no último ano. Example: 3402.88 - `min_monthly_salary_3y` (number,null, required) O salário mensal mínimo do indivíduo nos últimos três anos. Example: 3402.88 - `min_monthly_salary_5y` (number,null, required) O salário mensal mínimo do indivíduo nos últimos cinco anos. Example: 3402.88 - `average_monthly_salary_1y` (number,null, required) O salário médio mensal do indivíduo no último ano. Example: 3402.88 - `average_monthly_salary_3y` (number,null, required) O salário médio mensal do indivíduo nos últimos três anos. Example: 3402.88 - `average_monthly_salary_5y` (number,null, required) O salário médio mensal do indivíduo nos últimos cinco anos. Example: 3402.88 - `max_monthly_salary_1y` (number,null, required) O salário mensal máximo do indivíduo no último ano. Example: 3402.88 - `max_monthly_salary_3y` (number,null, required) O salário mensal máximo do indivíduo nos últimos três anos. Example: 3402.88 - `max_monthly_salary_5y` (number,null, required) O salário mensal máximo do indivíduo nos últimos cinco anos. Example: 3402.88 ## Response 201 fields (application/json): - `id` (string, required) Identificador único da Belvo para o item atual. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `link` (string,null, required) O ao qual os dados pertencem. Example: "30cb4806-6e00-48a4-91c9-ca55968576c8" - `collected_at` (string, required) O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado. Example: "2022-02-09T08:45:50.406032Z" - `created_at` (string, required) O carimbo de data e hora ISO-8601 de quando o ponto de dados foi criado no banco de dados da Belvo. Example: "2022-02-09T08:45:50.406032Z" - `updated_at` (string,null, required) O carimbo de data/hora ISO-8601 de quando o cálculo das métricas de emprego foi atualizado pela última vez. Example: "2023-08-30T15:31:35.728607Z" - `reference_date` (string,null, required) A reference_date que você forneceu em sua solicitação. Se você não forneceu uma, este campo retornará , indicando que os cálculos são realizados até a data da solicitação. Todos os cálculos são relativos a esta data. Example: "2023-06-01" - `age` (integer, required) A idade do indivíduo. Example: 32 - `current_status` (string, required) Indica o status de emprego do indivíduo. Retornamos uma das seguintes respostas: - - - - Enum: "EMPLOYED", "RETIRED", "UNEMPLOYED", "null" - `current_employer_count` (integer,null, required) O número de empregadores que o indivíduo tem no momento. Example: 1 - `base_salary_last` (number,null, required) O salário base mais recente do usuário. Se for , este é o salário base atual do usuário. Example: 42.17 - `weeks_employed_last_job` (number,null, required) O número de semanas em que o usuário esteve empregado em seu último emprego. Se for , então este campo indica o número de semanas em que o usuário está empregado em seu emprego atual. Example: 327.1429 - `weeks_since_last_job` (number,null, required) O número de semanas desde o último emprego. Se o valor deste campo for , isso indica que o usuário está atualmente empregado. - `weeks_employed_total` (number,null, required) O número total de semanas em que o usuário esteve empregado, de acordo com a instituição. > > > No caso de o usuário estar empregado em dois ou mais lugares ao mesmo tempo, ainda calculamos essas semanas como uma semana. Por exemplo, se um usuário tem três empregos simultâneos por um mês, isso é calculado como 4 semanas. Example: 148.2 - `weeks_with_multiple_employers` (number,null, required) O número de semanas em que o indivíduo teve mais de um empregador ao mesmo tempo. - `employer_count` (integer,null, required) O número total de empregadores que o usuário teve. Útil para indicar a estabilidade de emprego ao longo de sua vida. Example: 14 - `unique_employer_count` (integer,null, required) O número de empregadores únicos que o indivíduo teve. > > > Se o usuário saiu de uma empresa e retornou, por exemplo, seis meses depois para a mesma empresa, isso é contado como um empregador. Example: 3 - `employers_per_year` (number,null, required) Número de empregadores por ano. Útil para indicar a estabilidade no emprego ao longo de um ano. > > > Se o usuário saiu de uma empresa e retornou, por exemplo, seis meses depois para a mesma empresa, isso é contado como um empregador. Example: 0.6326 - `weeks_between_jobs` (number,null, required) O número total de semanas em que o indivíduo esteve desempregado. Example: 687.2865 - `max_weeks_between_jobs` (number,null, required) O número máximo de semanas em que o indivíduo esteve desempregado. Example: 249.8571 - `increases_last_job` (integer,null, required) O número total de aumentos salariais que o usuário teve em seu último emprego. Se for , isso se refere ao emprego atual do usuário. > > > Para todos os aumentos ou reduções salariais, consideramos apenas aqueles em que a mudança no salário é superior a 2%. - `decreases_last_job` (integer,null, required) O número total de aumentos salariais que o usuário teve em seu último emprego. Se for , isso se refere ao emprego atual do usuário. - `increases_after_change` (integer,null, required) O número total de aumentos salariais entre o penúltimo emprego do indivíduo e o último (ou atual) emprego. - `decreases_after_change` (integer,null, required) O número total de reduções salariais entre o penúltimo emprego do indivíduo e o último (ou atual) emprego. - `increases_overall` (integer,null, required) O número total de aumentos salariais ao longo da carreira profissional do indivíduo. - `decreases_overall` (integer,null, required) O número total de reduções salariais ao longo da carreira profissional do indivíduo. - `increases_1y` (integer,null, required) O número total de aumentos salariais ao longo do último ano do indivíduo (YTD). - `decreases_1y` (integer,null, required) O número total de reduções salariais ao longo do último ano do indivíduo (YTD). - `increases_3y` (integer,null, required) O número total de aumentos salariais ao longo dos últimos três anos do indivíduo. > > > Se a carreira profissional do indivíduo for inferior a três anos, retornamos . - `decreases_3y` (integer,null, required) O número total de reduções salariais ao longo dos últimos três anos do indivíduo. > > > Se a carreira profissional do indivíduo for inferior a três anos, retornamos . - `increases_5y` (integer,null, required) O número total de aumentos salariais ao longo dos últimos cinco anos do indivíduo. > > > Se a carreira profissional do indivíduo for inferior a cinco anos, retornamos . - `decreases_5y` (integer,null, required) O número total de reduções salariais ao longo dos últimos cinco anos do indivíduo. > > > Se a carreira profissional do indivíduo for inferior a cinco anos, retornamos . - `yearly_change_1y` (number,null, required) A mudança percentual do salário do indivíduo para o último ano (YTD). - `yearly_change_3y` (number,null, required) A variação percentual do salário do indivíduo nos últimos três anos. > > > Se a carreira profissional do indivíduo for inferior a três anos, retornamos . - `yearly_change_5y` (number,null, required) A variação percentual do salário do indivíduo nos últimos cinco anos. > > > Se a carreira profissional do indivíduo for inferior a cinco anos, retornamos . - `min_monthly_salary_1y` (number,null, required) O salário mensal mínimo do indivíduo no último ano. Example: 3402.88 - `min_monthly_salary_3y` (number,null, required) O salário mensal mínimo do indivíduo nos últimos três anos. Example: 3402.88 - `min_monthly_salary_5y` (number,null, required) O salário mensal mínimo do indivíduo nos últimos cinco anos. Example: 3402.88 - `average_monthly_salary_1y` (number,null, required) O salário médio mensal do indivíduo no último ano. Example: 3402.88 - `average_monthly_salary_3y` (number,null, required) O salário médio mensal do indivíduo nos últimos três anos. Example: 3402.88 - `average_monthly_salary_5y` (number,null, required) O salário médio mensal do indivíduo nos últimos cinco anos. Example: 3402.88 - `max_monthly_salary_1y` (number,null, required) O salário mensal máximo do indivíduo no último ano. Example: 3402.88 - `max_monthly_salary_3y` (number,null, required) O salário mensal máximo do indivíduo nos últimos três anos. Example: 3402.88 - `max_monthly_salary_5y` (number,null, required) O salário mensal máximo do indivíduo nos últimos cinco anos. Example: 3402.88 ## Response 403 fields (application/json): - `code` (string) Um código de erro único () que permite classificar e tratar o erro programaticamente. ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com 403 access_to_resource_denied. Example: "access_to_resource_denied" - `message` (string) Uma breve descrição do erro. Para erros , a descrição é: - . Example: "You don't have access to this resource." - `request_id` (string) Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: ). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 404 fields (application/json): - `code` (string) Um código de erro único () que permite classificar e lidar com o erro programaticamente. Example: "not_found" - `message` (string) Uma breve descrição do erro. Para erros , a descrição é: - Example: "Not found" - `request_id` (string) Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: ). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 408 fields (application/json): - `code` (string) Um código de erro único () que permite classificar e lidar com o erro programaticamente. ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 408 request_timeout. Example: "request_timeout" - `message` (string) Uma breve descrição do erro. Para erros de , a descrição é: - . Example: "The request timed out, you can retry asking for less data by changing your query parameters" - `request_id` (string) Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: ). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 500 fields (application/json): - `code` (string) Um código de erro único () que permite classificar e tratar o erro de forma programática. ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 500 unexpected_error. Example: "unexpected_error" - `message` (string) Uma breve descrição do erro. Para erros , a descrição é: - . 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) Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: ). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações. Example: "9e7b283c6efa449c9c028a16b5c249fb"