---
title: "Consultar dados do seller"
method: GET
path: "/v2/seller"
tags: ["Sellers"]
---

# Consultar dados do seller

`GET /v2/seller`

Retorna os dados do seller com query parameters opcionais

## Query parameters

- `idSeller` string
- `document` string
- `sellerToken` string, uuid
- `page` integer
- `size` integer
- `sort` string

## Headers

- `X-Token-Api` string, uuid, required

## Response `200`

Dados do seller retornados com sucesso

- union
  - SellerGetResponse
    - `idSeller` integer
    - `document` string
    - `companyName` string
    - `fantasyName` string
    - `sellerUrl` string
    - `email` string, email
    - `token` string, uuid
    - `address` AddressResponse
      - `street` string
      - `number` string
      - `complement` string
      - `district` string
      - `city` string
      - `state` string
      - `country` string
      - `zipCode` string
    - `contacts` ContactResponse
      - `name` string
      - `email` string, email
      - `phone` string
    - `accounts` AccountResponse
      - `bank` integer
      - `issuer` string
      - `number` string
      - `pixKey` string
      - `pixKeyType` string
      - `accountType` string
      - `issuerDigit` integer
      - `transferType` string
    - `webhooks` Webhook[] — Array de webhooks do seller
      - `uuid` string, uuid — Identificador único do webhook
      - `title` string — Nome do webhook
      - `domains` string[] — Eventos vinculados (ORDER, SUBSCRIPTION)
      - `active` boolean — Indica se o webhook está ativo
      - `url` string, uri — URL configurada para recebimento
  - SellerListResponse
    - `content` SellerListItem[]
      - `id` integer
      - `company_name` string
      - `notification_email` string, email
      - `document` string
      - `sellerUrl` string, nullable
      - `token` string, uuid
    - `page` integer
    - `size` integer
    - `totalElements` integer
    - `totalPages` integer

## Other responses

- `400` — Erro de validação
- `401` — Token inativo ou inexistente
- `403` — Acesso negado
- `404` — Seller não encontrado
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada.md) · [All operations](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/barte/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1/schema)