---
title: "Listar contas de Marketplaces"
method: GET
path: "/{alias}/marketplaces/accounts"
tags: ["Marketplaces - Contas"]
---

# Listar contas de Marketplaces

`GET /{alias}/marketplaces/accounts`

## Request

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

Retorna uma lista de contas de marketplaces com um filtro opcional para contas ativas

## Path parameters

- `alias` string, required

## Query parameters

- `active` boolean
- `includes` string[]

## Response `200`

Contas de marketplaces listadas com sucesso

- object: Representa uma paginação com meta
  - `data` MarketplaceAccount[]
    - `id` integer
    - `store_id` integer
    - `marketplace_id` integer
    - `stock_id` integer
    - `active` boolean
    - `auto_sync_catalog` boolean
    - `name` string
    - `marketplace_user_id` integer
    - `price_attribute` string
    - `price_percentage` number, float
    - `default_status_id` integer
    - `params` object
      - `listing_type_id` string
      - `allow_sku_without_stock` boolean
    - `auth_params` object
      - `access_token` string
      - `expires_in` integer
      - `refresh_token` string
    - `marketplace` object
      - `data` object
        - `id` integer
        - `alias` string
        - `name` string
        - `auth_type` string
        - `needs_category_association` boolean
        - `icon_url` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` string, date-time
  - `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/marketplaces/accounts/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)