---
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}`

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

## Path parameters

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

## Query parameters

- `slug` string

## Response `200`

Banners do cliente

- Banner[]
  - `data` object[]
    - `imagem` 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.
    - `texto` TextoBanner
      - `texto` string
      - `cor` object
        - `texto` string
        - `fundo` string
    - `link` LinkBanner
      - `url` string
      - `abertura` 'mesma_pagina' | 'nova_pagina'
  - `pagination` object
    - `total` integer
    - `perPage` integer
    - `currentPage` integer
    - `lastPage` integer
  - `status` 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/revisions/42bf5add8bf3/schema)