# Buscar Vendedores

## Consultar dados do seller

> Retorna os dados do seller com query parameters opcionais

```json
{"openapi":"3.0.0","info":{"title":"API de Sellers v2 - Atualizada","version":"2.1.0"},"servers":[{"url":"https://api.barte.com","description":"Servidor de produção"},{"url":"https://sandbox-api.barte.com","description":"Servidor de sandbox"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Token-Api"}},"schemas":{"SellerGetResponse":{"type":"object","properties":{"idSeller":{"type":"integer"},"document":{"type":"string"},"companyName":{"type":"string"},"fantasyName":{"type":"string"},"sellerUrl":{"type":"string"},"email":{"type":"string","format":"email"},"token":{"type":"string","format":"uuid"},"address":{"$ref":"#/components/schemas/AddressResponse"},"contacts":{"$ref":"#/components/schemas/ContactResponse"},"accounts":{"$ref":"#/components/schemas/AccountResponse"},"webhooks":{"type":"array","description":"Array de webhooks do seller","items":{"$ref":"#/components/schemas/Webhook"}}}},"AddressResponse":{"type":"object","properties":{"city":{"type":"string"},"state":{"type":"string"},"number":{"type":"string"},"street":{"type":"string"},"country":{"type":"string"},"zipCode":{"type":"string"},"district":{"type":"string"},"complement":{"type":"string"}}},"ContactResponse":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string"}}},"AccountResponse":{"type":"object","properties":{"bank":{"type":"integer"},"issuer":{"type":"string"},"number":{"type":"string"},"pixKey":{"type":"string"},"pixKeyType":{"type":"string"},"accountType":{"type":"string"},"issuerDigit":{"type":"integer"},"transferType":{"type":"string"}}},"Webhook":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid","description":"Identificador único do webhook"},"title":{"type":"string","description":"Nome do webhook"},"domains":{"type":"array","description":"Eventos vinculados (ORDER, SUBSCRIPTION)","items":{"type":"string","enum":["ORDER","SUBSCRIPTION"]}},"active":{"type":"boolean","description":"Indica se o webhook está ativo"},"url":{"type":"string","format":"uri","description":"URL configurada para recebimento"}}},"SellerListResponse":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/SellerListItem"}},"page":{"type":"integer"},"size":{"type":"integer"},"totalElements":{"type":"integer"},"totalPages":{"type":"integer"}}},"SellerListItem":{"type":"object","properties":{"id":{"type":"integer"},"company_name":{"type":"string"},"notification_email":{"type":"string","format":"email"},"document":{"type":"string"},"sellerUrl":{"type":"string","nullable":true},"token":{"type":"string","format":"uuid"}}},"ValidationError":{"type":"object","properties":{"errors":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}},"AuthenticationError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}}},"ForbiddenError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}}},"NotFoundError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}}},"InternalError":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"}}}}}}}},"paths":{"/v2/seller":{"get":{"summary":"Consultar dados do seller","description":"Retorna os dados do seller com query parameters opcionais","tags":["Sellers"],"parameters":[{"name":"X-Token-Api","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"Token de autenticação UUID v4"},{"name":"idSeller","in":"query","required":false,"schema":{"type":"string"},"description":"ID do seller para consulta"},{"name":"document","in":"query","required":false,"schema":{"type":"string"},"description":"Documento do seller para consulta (CPF ou CNPJ)"},{"name":"sellerToken","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Token do seller para consulta"},{"name":"page","in":"query","required":false,"schema":{"type":"integer"},"description":"Número da página para paginação"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","default":10,"maximum":1000},"description":"Quantidade de registros por página (padrão 10, máximo 1000)"},{"name":"sort","in":"query","required":false,"schema":{"type":"string"},"description":"Ordenação dos resultados (ex. companyName,desc)"}],"responses":{"200":{"description":"Dados do seller retornados com sucesso","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/SellerGetResponse"},{"$ref":"#/components/schemas/SellerListResponse"}]}}}},"400":{"description":"Erro de validação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}},"401":{"description":"Token inativo ou inexistente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthenticationError"}}}},"403":{"description":"Acesso negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"404":{"description":"Seller não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}}},"500":{"description":"Erro interno do servidor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}}}}}}}
```