---
title: "Consultar períodos aquisitivos de férias"
method: GET
path: "/v1/pessoal/periodos-aquisitivos-ferias"
tags: ["HCM Cadastros"]
---

# Consultar períodos aquisitivos de férias

`GET /v1/pessoal/periodos-aquisitivos-ferias`

## Request

- Base URL: `https://api.sankhya.com.br`
- URL: `https://api.sankhya.com.br/v1/pessoal/periodos-aquisitivos-ferias`
- Auth: API key in header `Authorization`

Retorna os períodos aquisitivos de férias **não gozados** cadastrados no SankhyaOm. Um período não gozado pode ter saldo de dias igual a zero. Por padrão, esses períodos com saldo zerado também não são retornados; utilize o parâmetro `saldoZerado=true` para incluí-los.

**Regras de filtro:**
- `codigoFuncionario` só pode ser informado em conjunto com `codigoEmpresa`.

 Versão mínima do módulo pessoal: **5.102.0**

## Query parameters

- `codigoEmpresa` integer
- `codigoFuncionario` integer
- `updatedSince` string
- `saldoZerado` boolean
- `page` integer

## Response `200`

Lista de períodos aquisitivos retornada com sucesso.

- PeriodosAquisitivosFeriasResponse
  - `periodosAquisitivos` PeriodoAquisitivoFerias[]
    - `empresa` object
      - `codigo` integer: Código da empresa. Entidade: **EmpresaPessoal** (TFPFUN.CODEMP).
      - `nomeFantasia` string: Nome fantasia da empresa.
    - `funcionario` object
      - `codigo` integer: Código do funcionário. Entidade: **Funcionário** (TFPFUN.CODFUNC).
      - `nome` string: Nome completo do funcionário.
    - `periodoAquisitivo` object: Intervalo de datas do período aquisitivo de férias.
      - `dataInicio` string: Data de início do período aquisitivo. Formato: **dd/MM/yyyy HH:mm:ss**.
      - `dataFim` string: Data de fim do período aquisitivo. Formato: **dd/MM/yyyy HH:mm:ss**.
    - `abonoPecuniario` integer: Total de dias convertidos em abono pecuniário (venda de dias de férias). Entidade: **VFPPeriodoAquisitivoFerias** (ABONOPECUNIARIO).
    - `faltasNoPeriodo` integer: Quantidade de faltas registradas no período aquisitivo. Entidade: **VFPPeriodoAquisitivoFerias** (FALTPER).
    - `diasPerdidoFaltas` integer: Dias de férias perdidos em razão das faltas no período, conforme tabela progressiva da CLT. Entidade: **VFPPeriodoAquisitivoFerias** (DIASPERDIDOFALTAS).
    - `diasFeriasGozados` integer: Total de dias de férias já gozados ou com gozo agendado (sequências com data prevista informada). Entidade: **VFPPeriodoAquisitivoFerias** (NUMDIASFER).
    - `licencaRemunerada` integer: Dias de licença remunerada no período. Entidade: **VFPPeriodoAquisitivoFerias** (LICENCAREMUNERADA).
    - `adianta13` boolean: Indica se o adiantamento do 13° salário foi solicitado nas férias.
    - `saldoDias` integer: Saldo de dias de férias disponíveis para gozo. Calculado como: `MAIOR(30 - diasPerdidoFaltas - abonoPecuniario - diasFeriasGozados, 0)`. Entidade: **VFPPeriodoAquisitivoFerias** (SALDODIAS).
    - `dataAlteracao` string: Data e hora da última alteração no período aquisitivo. Formato: **dd/MM/yyyy HH:mm:ss**.

## Other responses

- `400`: Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `401`: Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `403`: Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `404`: Dados não encontrados. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `500`: Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `501`: Não implementado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `502`: Retorno inválido do servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `503`: Serviço indisponível no momento. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `504`: Tempo de execução excedido. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.

## Changes

- **2026-11-03** `b3c833e7aab1`: 1 breaking, 1 warning, 3 info
  - the `error` response's property type changed from `string` to `object` for status `400`
  - removed the optional property `mensagem` from the response with the `400` status
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/details` to the response with the `400` status
  - …1 more

[Operation history](https://skmtc.dev/sankhya/apis/api-sankhya/changes/v1/pessoal/periodos-aquisitivos-ferias/get.md)

---

[API](https://skmtc.dev/sankhya/apis/api-sankhya.md) - [All operations](https://skmtc.dev/sankhya/apis/api-sankhya/llms.txt) - [OpenAPI document](https://skmtc.dev/sankhya/apis/api-sankhya/revisions/b3c833e7aab1?raw)