> For the complete documentation index, see [llms.txt](https://outboundpro.gitbook.io/api-v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://outboundpro.gitbook.io/api-v1/user.md).

# User

## Listar usuários do cliente

> Retorna \*\*todos os usuários da conta do cliente\*\* (ativos e inativos),\
> incluindo grupos de ACL.\
> \
> \### Quando usar\
> \- Descobrir \`usuario\_id\` para usar em outros endpoints\
>   (\[\`list/create\`]\(#operation/listCreate), \[\`list/edit\`]\(#operation/listEdit)).\
> \- Mapear \`prevendedor\_id\` válidos.\
> \- Provisionar usuários espelhados no seu sistema interno (CRM, BI).\
> \
> Apenas leitura. Provisioning de usuário (create/update/delete) é feito no\
> painel.<br>

```json
{"openapi":"3.0.3","info":{"title":"OutboundPro API","version":"2.0.0"},"tags":[{"name":"User","description":"**Usuários do cliente** — quem tem acesso ao painel OutboundPro.\n\nÚtil para descobrir `usuario_id` e `prevendedor_id` que outros endpoints\naceitam (criar/editar lista, atribuir lead, etc.). Apenas leitura via API.\n"}],"servers":[{"url":"https://app.outboundpro.com.br/api","description":"Produção"}],"security":[{"TokenAuth":[]}],"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Token","description":"Chave privada do cliente (`cli_chave_privada`). Formato UUID v4\n(36 caracteres com hífens). Aceita header em qualquer case\n(`Token`, `token`, `TOKEN`).\n"}},"schemas":{"User":{"type":"object","properties":{"id":{"type":"integer","description":"ID interno do usuário (`usu_codigo`). Use em outros endpoints como\n`prevendedor_id` ou `usuario_id`.\n"},"nome":{"type":"string"},"sobrenome":{"type":"string"},"nome_completo":{"type":"string"},"email":{"type":"string","format":"email"},"telefone":{"type":"string","nullable":true},"data_nascimento":{"type":"string","format":"date","nullable":true},"status":{"type":"string","enum":["Ativo","Inativo"]},"tipo_usuario":{"type":"string","enum":["Proprietário","Comum"],"description":"Proprietário = admin do cliente; Comum = usuário regular."},"crm_admin":{"type":"boolean","description":"Se tem permissões de admin no módulo CRM (Funil, Pipelines)."},"data_ultimo_acesso":{"type":"string","format":"date-time","nullable":true},"data_cadastro":{"type":"string","format":"date-time"},"grupos":{"type":"object","description":"Map de `grupo_id` → nome do grupo (ACL).","additionalProperties":{"type":"string"}}}},"ErrorResponse":{"type":"object","required":["response"],"properties":{"response":{"type":"string","enum":["error"]},"mensagem":{"type":"string","description":"Descrição do erro em pt-BR. Família Contact usa `message` (legado)."},"message":{"type":"string","description":"Equivalente inglês de `mensagem`, usado pela família Contact."}}}},"responses":{"Unauthorized":{"description":"Token ausente, inválido ou cliente inativo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/user/list":{"get":{"tags":["User"],"summary":"Listar usuários do cliente","operationId":"userList","description":"Retorna **todos os usuários da conta do cliente** (ativos e inativos),\nincluindo grupos de ACL.\n\n### Quando usar\n- Descobrir `usuario_id` para usar em outros endpoints\n  ([`list/create`](#operation/listCreate), [`list/edit`](#operation/listEdit)).\n- Mapear `prevendedor_id` válidos.\n- Provisionar usuários espelhados no seu sistema interno (CRM, BI).\n\nApenas leitura. Provisioning de usuário (create/update/delete) é feito no\npainel.\n","responses":{"200":{"description":"Usuários do cliente.","content":{"application/json":{"schema":{"type":"object","properties":{"response":{"type":"string","enum":["success"]},"usuarios":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```