---
title: "Retornar as associações ao cliente"
method: GET
path: "/associacoes"
tags: ["Associações de Pessoas"]
---

# Retornar as associações ao cliente

`GET /associacoes`

> 🔒 **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)

## Query parameters

- `idAssociacao` integer
- `offset` integer
- `limit` integer

## Response `200`

Listagem de Associações

- Associacoes
  - `total` integer
  - `offset` integer
  - `limit` integer
  - `associacoes` Associacao[]
    - `idassociacao` integer
    - `nome_associado` string
    - `tipo_associacao` TipoAssociacao
      - `idtipo` integer
      - `nome` string
    - `unidades` Unidade[]
      - `unidades` Unidades[]
        - `idunidade` integer
        - `nome` string
      - `perfil` Perfil
        - `nome` string
        - `sigla` string
      - `previsao_entrega` string
      - `porcentagem_total_estagio_obra_unidade` number
      - `grupo_especial` number
      - `etapa` Etapa
        - `idetapa` integer
        - `nome` string
      - `bloco` Bloco
        - `idbloco` integer
        - `nome` string
      - `empreendimento` Empreendimento
        - `idempreendimento` integer
        - `nome` string
        - `porcentagem_total_estagio_obra` number
        - `permitir_criar_atendimento` boolean
        - `foto` Imagem — Imagem vinda do Construtor
          - `nome` string, required
          - `tipo` string, required
          - `dispositivo_exibicao` string — desktop, mobile ou todos
          - `tamanho` integer, required
          - `url` string, required — Substituir [[LARGURA]] e [[ALTURA]] pelos valores de largura e altura desejados, ambos também podem ser substituidos por 'x' para obter o tamanho original da imagem.
      - `andar` string
      - `coluna` string

## Other responses

- `404` — Nenhum dado encontrado!
- `422` — Erro interno ao realizar ação!

---

[API](https://skmtc.net/cvcrm/apis/clientes.md) · [All operations](https://skmtc.net/cvcrm/apis/clientes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cvcrm/clientes/versions/42bf5add8bf3/schema)