---
title: "Listar vendedores"
method: GET
path: "/{alias}/checkout/sellers"
tags: ["Checkout - Vendedores"]
---

# Listar vendedores

`GET /{alias}/checkout/sellers`

## Request

- Base URL: `https://api.dooki.com.br/v2`
- URL: `https://api.dooki.com.br/v2/{alias}/checkout/sellers`
- Auth: API key in header `User-Token` and API key in header `User-Secret-Key`

Lista os vendedores associados à loja identificada pelo alias

## Path parameters

- `alias` string, required

## Response `200`

Lista de vendedores

- object: Representa uma paginação com meta
  - `data` Seller[]: Vendedores cadastrados na loja.
    - `id` integer: Identificador único do vendedor.
    - `affiliation_id` integer: ID da afiliação de pagamento em que o vendedor foi cadastrado; aceita apenas afiliações do gateway Pagar.me.
    - `bank_account_id` integer: ID da conta bancária que recebe as transferências do vendedor.
    - `store_alias` string: Alias da loja à qual o vendedor pertence.
    - `has_split` boolean: Indica se o vendedor participa do split de pagamento dos pedidos.
    - `transfer_enabled` boolean, required: Indica se as transferências automáticas para o vendedor estão habilitadas.
    - `active` boolean: Indica se o vendedor está ativo.
    - `name` string, required: Nome do vendedor.
    - `email` string, required: E-mail do vendedor, único dentro da loja.
    - `document` string, required: CPF ou CNPJ do vendedor, conforme o `document_type`, único dentro da loja.
    - `document_type` string, required: Tipo do documento informado em `document` (`cpf` ou `cnpj`).
    - `transfer_interval` string, required: Periodicidade das transferências automáticas para o vendedor (`daily`, `weekly` ou `monthly`).
    - `transfer_day` string, required: Dia da transferência automática, conforme o `transfer_interval`: `0` no diário, de 1 a 5 no semanal (dia da semana) e de 1 a 30 no mensal.
    - `anticipatable_volume_percentage` integer: Percentual do volume de vendas do vendedor disponível para antecipação.
    - `automatic_anticipation_enabled` boolean: Indica se a antecipação automática dos recebíveis do vendedor está habilitada.
    - `ref_code` string, required: Código de referência do vendedor definido pela loja, único dentro da loja.
    - `external_gateway_id` string: ID do vendedor no gateway de pagamento.
    - `percentage_products` integer, required: Percentual do valor dos produtos repassado ao vendedor no split.
    - `percentage_shipping` integer, required: Percentual do valor do frete repassado ao vendedor no split.
    - `charge_processing_fee` boolean: Indica se a taxa de processamento do pagamento é descontada do valor repassado ao vendedor quando há chargeback.
    - `liable` boolean, required: Indica se o vendedor é responsável pelos chargebacks das vendas em que participa do split.
  - `meta` object: Metadados da resposta.
    - `pagination` object: Dados de paginação do resultado.
      - `total` integer: Quantidade total de registros encontrados, considerando todas as páginas.
      - `count` integer: Quantidade de registros retornados na página atual.
      - `per_page` integer: Quantidade máxima de registros por página.
      - `current_page` integer: Número da página atual.
      - `total_pages` integer: Quantidade total de páginas do resultado.
      - `links` object: Links de navegação entre as páginas do resultado.
        - `previous` string: URL da página anterior, ausente quando a página atual é a primeira.
        - `next` string: URL da próxima página, ausente quando a página atual é a última.

## Other responses

- `400`: Requisição inválida

## Changes

- **2026-11-03** `bbafb577e11c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yampi/apis/yampi-api/changes/:alias/checkout/sellers/get.md)

---

[API](https://skmtc.dev/yampi/apis/yampi-api.md) - [All operations](https://skmtc.dev/yampi/apis/yampi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yampi/apis/yampi-api/revisions/74739ec8876f?raw)