---
title: "Listar tipos de arquivos"
method: GET
path: "/v4/configuracoes/tipos-arquivos"
tags: ["Tipos de Arquivos"]
---

# Listar tipos de arquivos

`GET /v4/configuracoes/tipos-arquivos`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/v4/configuracoes/tipos-arquivos`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-nas-apis-do-cv-crm-com-bearer-token)

Retorna a listagem paginada de tipos de arquivos ativos. Autenticação via JWT Bearer token.
Os filtros aceitam o padrão `search[operador|campo]=valor`. Operadores disponíveis:
`equal` (igual), `notEqual` (diferente), `like` (contém), `in` (lista), `notIn` (fora da lista), `greaterThan` (maior que), `lessThan` (menor que), `isNull` (campo não preenchido), `isNotNull` (campo preenchido).
Exemplo: `search[like|nome]=RG`, `search[equal|ativoPainel]=S`, `search[equal|funcionalidade]=reservas`

## Query parameters

- `pagina` integer
- `registros_por_pagina` integer
- `sort` string
- `order` 'ASC' | 'DESC'
- `search[like|nome]` string
- `search[equal|tipoPessoa]` 1 | 2 | 3
- `search[equal|funcionalidade]` 'reservas' | 'pre_cadastro' | 'ambos'
- `search[equal|visivelPara]` 'T' | 'G'
- `search[equal|ativoPainel]` 'S' | 'N'
- `search[equal|obrigatorioWorkflow]` 'S' | 'N'
- `search[equal|assinaturaDigital]` 'S' | 'N'
- `search[equal|contrato]` 'S' | 'N'
- `search[equal|exibirGestaoContrato]` 'S' | 'N'
- `search[equal|exibirPainelCliente]` 'S' | 'N'
- `search[equal|utilizarSmartDocs]` 'S' | 'N'
- `search[equal|possuiValidade]` 'S' | 'N'

## Response `200`

Tipos de arquivos retornados com sucesso.

- ListarTiposArquivosV4
  - `status` string
  - `code` integer
  - `pagination` object
    - `pagina` integer
    - `registros` integer
    - `totalRegistros` integer
    - `totalPaginas` integer
  - `data` TipoArquivoItemV4[]
    - `idtipo` integer
    - `nome` string
    - `tipoPessoa` integer, nullable
    - `tipoPessoaDescricao` string, nullable
    - `ordem` integer, nullable
    - `obrigatorioWorkflow` boolean
    - `visivelPara` string
    - `assinaturaDigital` boolean
    - `contrato` boolean
    - `exibirGestaoContrato` boolean
    - `exibirPainelCliente` boolean
    - `utilizarSmartDocs` boolean
    - `funcionalidade` string
    - `ativoPainel` boolean
    - `dataCad` string, date-time
    - `possuiValidade` boolean
    - `tempoValidade` integer, nullable: Tempo de validade em meses. Preenchido apenas quando possuiValidade é true.

## Other responses

- `400`: Filtro ou parâmetro de busca inválido.
- `401`: Token inválido ou não informado.
- `500`: Erro interno do servidor.

---

[API](https://skmtc.dev/cvcrm/apis/cadastro-gerais-do-ambiente-do-cv.md) - [All operations](https://skmtc.dev/cvcrm/apis/cadastro-gerais-do-ambiente-do-cv/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/cadastro-gerais-do-ambiente-do-cv/revisions/14e5663d1cb0?raw)