---
title: "Retorna os tipos de associações disponíveis"
method: GET
path: "/v1/cadastros/tipos-associacoes"
tags: ["Tipos de Associações"]
---

# Retorna os tipos de associações disponíveis

`GET /v1/cadastros/tipos-associacoes`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/v1/cadastros/tipos-associacoes`
- Auth: none declared. Required headers: `email`, `token`

> 🔒 **Autenticação necessária**
>
> Esta API utiliza autenticação via **e-mail e token** nos headers da requisição.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token)

A api tem por objetivo demonstrar os tipos de associações cadastradas no ambiente do cliente.
Denomina-se associação no construtor de vendas, a ligação das pessoas participantes da reserva com o titular.
Ex.: Sócio, Conjuge, Repreentante.

O campo exibir para pessoa (exibir_para_pessoa) faz a relação se o tipo de associação estará vinculado somente as pessoas do tipo Física, Jurídica ou ambos quando for pertinente aos dois tipos de pessoas.
FISISCA (Física), JURIDICA (Jurídica), AMBOS (Física e Jurídica)

## Query parameters

- `pagina` integer
- `registros_por_pagina` integer
- `exibir_para_pessoa` string

## Headers

- `email` string, required
- `token` string, required

## Response `200`

Tipos de Associações

- RetornarTipos: Retorna tipos de associações.
  - `pagina` integer
  - `total_de_paginas` integer
  - `registros` integer
  - `total_de_registros` integer
  - `dados` RetornarTiposAssociacoes[]
    - `idtipo` integer: Código do tipo de associação
    - `nome` string: Descrição do tipo de associação
    - `conjuge` string
    - `avalista` string: Se o tipo de associação é avalista
    - `exibir_para_pessoa` string: Qual tipo de pessoa usará o tipo de associação

## Other responses

- `404`: Erro ao tentar encontrar os tipos de associações!
- `422`: Erro ao tentar retornar tipos de associações!

---

[API](https://skmtc.dev/cvcrm/apis/clientes.md) - [All operations](https://skmtc.dev/cvcrm/apis/clientes/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/clientes/revisions/42bf5add8bf3?raw)