Sub-contas - Listar

Visão Geral

Lista as sub-contas da sua plataforma, com paginação e filtros por status, nome e plano. Cada item traz o mesmo objeto de Consultar, incluindo o volume aprovado dos últimos 30 dias.

Requisição

HTTP

GET /v1/marketplace/sub-accounts

Parâmetros de Consulta

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
`limit`	integer	Não	Itens por página (1–100; padrão 20)	`50`
`offset`	integer	Não	Deslocamento (padrão 0)	`100`
`status`	string	Não	Só as sub-contas neste status (`pending`, `analyzing`, `awaiting-documents`, `active`, `blocked`, `disabled`)	`"analyzing"`
`q`	string	Não	Parte do nome (sem distinguir maiúsculas)	`"maria"`
`planId`	string	Não	Só as sub-contas neste plano (`rate_…`), ou `none` para as que não têm plano	`"none"`

Resposta

Sucesso (200 OK)

JSON

{
  "offset": 0,
  "limit": 20,
  "total": 2,
  "page": {
    "offset": { "first": 0, "prev": 0, "next": 0, "last": 0 },
    "current": 1,
    "total": 1
  },
  "data": [
    {
      "id": "bus_01hqzvsub1",
      "name": "Loja da Maria",
      "status": "active",
      "platformFee": null,
      "planId": "rate_01hqzvplan1",
      "createdAt": "2026-10-17T12:00:00.000Z",
      "kycSubmittedAt": "2026-10-17T15:20:11.000Z",
      "approvedAt": "2026-10-18T10:02:45.000Z",
      "volume30dCents": 1250000
    },
    {
      "id": "bus_01hqzvsub2",
      "name": "Bazar do João",
      "status": "pending",
      "platformFee": { "type": "flat", "value": 300 },
      "planId": null,
      "createdAt": "2026-10-17T13:30:00.000Z",
      "kycSubmittedAt": null,
      "approvedAt": null,
      "volume30dCents": 0
    }
  ],
  "hasMore": false
}

Campo	Descrição
`total`	Quantas sub-contas atendem aos filtros
`page`	Navegação por página: os `offset` da primeira, anterior, próxima e última página, a página atual e o total de páginas
`data[]`	As sub-contas — campos em Visão Geral
`hasMore`	`true` quando há mais itens depois desta página

volume30dCents vem null em todos os itens quando a leitura do volume não estava disponível; a lista nunca falha por isso.

Exemplo

Shell

curl "https://api.selectwin.io/v1/marketplace/sub-accounts?status=analyzing&limit=50" \
     -H "SelectKey: sk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ"

AnteriorCriar PróximaConsultar

Atualizado em 21 de outubro de 2026

Sub-contas - Listar

#Visão Geral

#Requisição

#Parâmetros de Consulta

#Resposta

#Sucesso (200 OK)