---
title: "Retorna os banners ativos do painel do cliente"
method: GET
path: "/banners/{lugarExibicao}"
tags: ["Banners"]
---

# Retorna os banners ativos do painel do cliente

`GET /banners/{lugarExibicao}`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/cliente`
- URL: `https://integracao.cvcrm.com.br/api/v1/cliente/banners/{lugarExibicao}`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization, gerado pelo endpoint de autenticação do próprio Portal do Cliente: `POST /api/v1/cliente/autenticacao` (documento e senha do cliente) ou `POST /api/v1/cliente/autenticacao/sindico` (síndicos).
> ⚠️ O token de integração das APIs v2/v3 (`POST /api/v3/auth/token`) **não é válido** para o Portal do Cliente: ele não representa um cliente e as consultas retornarão vazias ou dados incorretos.

## Path parameters

- `lugarExibicao` 'home_topo' | 'home_sidebar' | 'login', required

## Query parameters

- `slug` string

## Response `200`

Banners do cliente

- object
  - `data` object[]
    - `imagem` object
      - `nome` string
      - `tipo` string
      - `dispositivo_exibicao` string
      - `tamanho` integer
      - `url` string
    - `texto` string, nullable
    - `link` string, nullable
  - `pagination` object[]
  - `status` string

## Other responses

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

---

[API](https://skmtc.dev/cvcrm/apis/portal-do-cliente.md) - [All operations](https://skmtc.dev/cvcrm/apis/portal-do-cliente/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/portal-do-cliente/revisions/7d95f9678127?raw)