---
title: "Consulta os sellers"
method: GET
path: "/api/marketplace/sellers"
tags: ["Marketplace"]
---

# Consulta os sellers

`GET /api/marketplace/sellers`

Retorna a lista de sellers vinculados à empresa autenticada, com suporte à pesquisa por nome ou CPF/CNPJ.

A busca por **Nome** ou **CpfCnpj** é feita com **similaridade**. Para busca exata por CPF/CNPJ, o valor deve conter apenas os dígitos, **SEM** pontos ou traços.

### Requisição

| **Campo** | **Tipo**  | **Descrição**                                                                 | **Obrigatório** |
|-----------|-----------|------------------------------------------------------------------------------|------------------|
| Nome      | Texto     | Parte do nome da seller a ser pesquisada | Não              |
| CpfCnpj   | Texto     | CPF/CNPJ | Não              |
| Page      | Número    | Número da página da consulta (paginação começa em 1) | Não (default = 1)|

### Resposta

A resposta da requisição retorna um objeto com os dados de paginação e a lista de sellers encontrados.

#### Estrutura de resposta:

**SellerConsultaResponse**

| **Campo**         | **Tipo**                            | **Descrição**                                                                 |
|-------------------|--------------------------------------|------------------------------------------------------------------------------|
| Pages             | Número                              | Total de páginas disponíveis |
| Total             | Número                              | Quantidade total de sellers encontrados |
| Items             | Array[SellerConsultaItemResponse]   | Lista dos sellers |

**SellerConsultaItemResponse**

| **Campo**             | **Tipo**    | **Descrição**                                                                 |
|------------------------|------------|------------------------------------------------------------------------------|
| Id                     | Texto      | ID do seller |
| Nome                   | Texto      | Nome do seller |
| RazaoSocial            | Texto      | Razão Social (ou mesmo nome para pessoa física) |
| Pessoa                 | Texto      | Tipo de pessoa: F (Física) ou J (Jurídica) |
| CPFCNPJ                | Texto      | CPF/CNPJ do seller |
| Titularidade           | Texto      | Nome exato do titular da conta |
| NomeCurto              | Texto      | Nome abreviado usado em notificações (ex: SMS) |
| Email                  | Texto      | Endereço de e-mail |
| Telefone               | Texto      | Telefone com DDD no formato 00-0000-0000 |
| Cep                    | Texto      | Código de Endereçamento Postal |
| Logradouro             | Texto      | Rua, avenida, etc |
| Complemento            | Texto      | Complemento do endereço |
| Numero                 | Texto      | Número do endereço |
| Bairro                 | Texto      | Nome do bairro |
| Cidade                 | Texto      | Nome da cidade |
| UF                     | Texto      | Unidade da federação (UF), ex: SP, RJ |
| Ativo                  | Booleano   | Indica se o seller está ativo ou inativo |
| ContaDestinoId         | Texto      | Identificador único da conta destino cadastrada |
| CodigoBanco            | Texto      | Código do banco (padrão Febraban) |
| AgenciaConta           | Texto      | Número da agência |
| DigitoAgenciaConta     | Texto      | Dígito verificador da agência |
| NumeroConta            | Texto      | Número da conta |
| DigitoNumeroConta      | Texto      | Dígito verificador da conta |

## Query parameters

- `Nome` string
- `CpfCnpj` string
- `Page` integer

## Headers

- `Aeskey` string, required

## Response `200`

Lista dos seller cadastrados

- BknBankPagamentosBusinessSellerConsultaResponse
  - `Pages` integer
  - `Total` integer
  - `Items` BknBankPagamentosBusinessSellerConsultaItemResponse[]
    - `Id` string, uuid
    - `Nome` string
    - `RazaoSocial` string
    - `Pessoa` string
    - `CPFCNPJ` string
    - `Titularidade` string
    - `NomeCurto` string
    - `Email` string
    - `Telefone` string
    - `Cep` string
    - `Logradouro` string
    - `Complemento` string
    - `Numero` string
    - `Bairro` string
    - `Cidade` string
    - `UF` string
    - `Ativo` boolean
    - `ContaDestinoId` string, uuid
    - `CodigoBanco` string
    - `AgenciaConta` string
    - `DigitoAgenciaConta` string
    - `NumeroConta` string
    - `DigitoNumeroConta` string

## Other responses

- `400` — Parâmetros inválidos
- `500` — Erro interno ao processar consulta

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)