# Obter detalhes de uma métrica de emprego

Obtenha os detalhes de uma métrica de emprego específica.

Endpoint: GET /api/employment-metrics/{id}/
Version: 1.223.0
Security: basicAuth

## Path parameters:

  - `id` (string, required)
    O  sobre o qual você deseja obter informações detalhadas.

## 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.

## 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 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"