> For the complete documentation index, see [llms.txt](https://changelog.maino.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.maino.com.br/api-reference-maino/04.-representantes.md).

# 04. 👨‍💼 Representantes

**Consulta de representantes comerciais** Listagem de representantes e vendedores cadastrados no sistema. **Funcionalidades:**

* Listar representantes e vendedores
* Filtrar por data de última modificação
* Verificar status do cadastro (ativo/inativo)

## Lista representantes/vendedores

> \*\*Lista representantes/vendedores cadastrados\*\*\
> \
> Retorna lista paginada dos representantes/vendedores\
> cadastrados no sistema. Útil para consulta de equipe comercial\
> e seleção em formulários.\
> \
> \*\*Funcionalidades:\*\*\
> \- Listagem paginada (100 itens por página)\
> \- Filtro por data de última modificação\
> \- Ordenação por data de criação\
> \
> \*\*Filtros disponíveis:\*\*\
> \- ultima\_modificacao: Filtra representantes alterados após uma data específica\
> \
> \*\*Campos retornados:\*\*\
> \- uuid: Identificador único do representante\
> \- nome: Nome completo\
> \- email: Email para contato\
> \- ddd: Código de área do telefone\
> \- telefone: Número do telefone\
> \- ativo: Indica se o cadastro está ativo\
> \
> \*\*Uso típico:\*\*\
> \- Seleção de vendedores em pedidos\
> \- Relatórios de equipe comercial\
> \- Sincronização de dados\
> \- Listagens administrativas

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"04. 👨‍💼 Representantes","description":"**Consulta de representantes comerciais**\nListagem de representantes e vendedores cadastrados no sistema.\n**Funcionalidades:**\n- Listar representantes e vendedores\n- Filtrar por data de última modificação\n- Verificar status do cadastro (ativo/inativo)"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/representantes":{"get":{"summary":"Lista representantes/vendedores","tags":["04. 👨‍💼 Representantes"],"description":"**Lista representantes/vendedores cadastrados**\n\nRetorna lista paginada dos representantes/vendedores\ncadastrados no sistema. Útil para consulta de equipe comercial\ne seleção em formulários.\n\n**Funcionalidades:**\n- Listagem paginada (100 itens por página)\n- Filtro por data de última modificação\n- Ordenação por data de criação\n\n**Filtros disponíveis:**\n- ultima_modificacao: Filtra representantes alterados após uma data específica\n\n**Campos retornados:**\n- uuid: Identificador único do representante\n- nome: Nome completo\n- email: Email para contato\n- ddd: Código de área do telefone\n- telefone: Número do telefone\n- ativo: Indica se o cadastro está ativo\n\n**Uso típico:**\n- Seleção de vendedores em pedidos\n- Relatórios de equipe comercial\n- Sincronização de dados\n- Listagens administrativas","parameters":[{"name":"ultima_modificacao","in":"query","schema":{"type":"string","format":"datetime"},"required":false,"description":"Filtrar apenas representantes modificados após esta data (formato ISO 8601)"},{"name":"page","in":"query","required":false,"description":"Número da página (padrão: 1, 100 itens por página)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista de representantes","content":{"Lista com representantes ativos":{},"Lista vazia":{},"application/json":{"schema":{"type":"object","properties":{"representantes":{"type":"array","description":"Lista dos representantes cadastrados","items":{"type":"object","properties":{"uuid":{"type":"string","description":"Identificador único do representante"},"nome":{"type":"string","description":"Nome completo"},"email":{"type":"string","format":"email","nullable":true,"description":"Email para contato"},"ddd":{"type":"string","nullable":true,"description":"Código de área do telefone"},"telefone":{"type":"string","nullable":true,"description":"Número do telefone"},"ativo":{"type":"boolean","description":"Indica se o representante está ativo no sistema"}},"required":["uuid","nome","ativo"]}},"pagination":{"type":"object","description":"Informações de paginação","properties":{"total":{"type":"integer","description":"Total de representantes cadastrados"},"previous_page":{"type":"string","description":"URL da página anterior","nullable":true},"next_page":{"type":"string","description":"URL da próxima página","nullable":true}},"required":["total"]}},"required":["representantes","pagination"]}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Erro de autenticação"}}}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://changelog.maino.com.br/api-reference-maino/04.-representantes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.