---
title: "Consulta Sellers"
method: GET
path: "/api/seller/sellers"
tags: ["Seller"]
---

# Consulta Sellers

`GET /api/seller/sellers`

Esta API permite realizar consultas dos sellers vinculado ao cliente logado, através da busca por Nome e CPF ou CNPJ.

### Requisição
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** |
|--|--|--|--| 
| Nome | Texto | Nome do Seller, aceita consulta parcial | Não | 
| CpfCnpj | Texto | CPF ou CPNJ do Seller, aceita consulta parcial | Não | 
| Page | Númerico | Quantidade de páginas geradas na consulta | Não |        
            
### Resposta
| **Campo** | **Tipo** | **Descrição** |        
|-------------------|----------|---------------------------------------------------------------------------|
| Pages             | Númerico | Número total de páginas retornadas na consulta do serviço|
| Total             | Númerico | Quantidade total de itens listados na consulta do serviço|
| Id                | GUID     | Identificador único do vendedor (seller)|
| Nome              | Texto    | Nome do vendedor (seller)|
| RazaoSocial       | Texto    | Razão social cadastrada do vendedor (seller)|
| Pessoa            | Texto    | Tipo de pessoa jurídica, representado por "J"|
| CPFCNPJ           | Texto    | Cadastro Nacional de Pessoa Jurídica do vendedor (CNPJ)|
| Titularidade      | Texto    | Nome completo ou referência designada ao titular da conta|
| NomeCurto         | Texto    | Nome curto ou abreviado usado pelo vendedor (seller)|
| Email             | Texto    | Endereço de e-mail de contato do vendedor (seller)|
| Telefone          | Texto    | Número de telefone para contato do vendedor (seller)|
| Cep               | Texto    | Código de Endereçamento Postal (CEP) referente ao endereço do vendedor|
| Logradouro        | Texto    | Nome do logradouro onde o vendedor está localizado|
| Complemento       | Texto    | Complemento do endereço, como número do bloco e apartamento|
| Numero            | Texto    | Número do endereço do vendedor|
| Bairro            | Texto    | Nome do bairro onde o vendedor está situado|
| Cidade            | Texto    | Cidade onde o vendedor está localizado|
| UF                | Texto    | Unidade Federativa (Estado) onde o vendedor está localizado|
| Ativo             | Booleano | Status ativo/inativo do vendedor, representado por verdadeiro (true)|
| ContaDestinoId    | GUID     | Identificador único da conta de destino do vendedor|
| CodigoBanco       | Texto    | Código do banco onde a conta está registrada|
| AgenciaConta      | Texto    | Número da agência bancária do vendedor|
| DigitoAgenciaConta| Texto    | Dígito verificador da agência bancária do vendedor|
| NumeroConta       | Texto    | Número da conta bancária do vendedor|
| DigitoNumeroConta | Texto    | Dígito verificador da conta bancária do vendedor|

## Query parameters

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

## Headers

- `Aeskey` string, required

## Response `200`

Sellers consultados com sucesso

- BknBankCobrancasBusinessSellerConsultaResponse[]
  - `Pages` integer
  - `Total` integer
  - `Items` BknBankCobrancasBusinessSellerConsultaItemResponse[]
    - `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` — Conteúdo inválido na requisição
- `500` — Erro interno

---

[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)