---
title: "GET | Listar todos os usuários relacionados"
slug: "api-get-list-all-related-users"
updated: 2026-03-06T13:10:57Z
published: 2026-03-06T13:10:57Z
canonical: "docs.senhasegura.io/api-get-list-all-related-users"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GET | Listar todos os usuários relacionados

Acesse informações de usuários relacionados no **Segura®**.

## Pré-requisitos

- Autorização com permissão de **acesso** ao recurso **Usuários** concedida pelo administrador no **A2A**.  

Saiba mais em [Como gerenciar autorizações no A2A](/v4-2/docs/pt/how-to-manage-authorizations-in-a2a).

## Requisição

` GET` `/api/user/related`

### Exemplo de requisição

` GET` `{{url}}api/user/related`

## Resposta

```
HTTP/1.1 200 OK
```

```
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "6 related users found",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "6 related users found",
        "erro": false,
        "cod_erro": 0
    },
    "relatedUsers": [
        {
            "id": "1",
            "name": "amandalices",
            "username": "alices"
        },
        {
            "id": "2",
            "name": "dleite",
            "username": "dleite"
        },
        {
            "id": "4",
            "name": "deboraleite",
            "username": "dleite"
        },
        {
            "id": "5",
            "name": "dleitef",
            "username": "dleite"
        },
        {
            "id": "6",
            "name": "deboraleiteferreira",
            "username": "dleite"
        },
        {
            "id": "8",
            "name": "duarte",
            "username": "paulopilotti"
        }
    ]
}
```

### Campos do corpo da resposta

<summary><code>relatedUsers</code> - <b>array de objetos</b> - Dados dos usuários relacionados.</summary>

<summary><code>id</code> - <b>int</b> - Código único de identificação do usuário relacionado gerado automaticamente pelo Segura® em <a href="/v4-2/docs/pt/api-post-create-related-user" rel="noopener">POST | Criar usuário relacionado</a>.</summary>

<summary><code>name</code> - <b>string</b> -  Nome atribuído ao usuário relacionado</summary>.

<summary><code>username</code> - <b>string</b> - Nome de identificação do usuário no Segura®</summary>.

## Erros

****404 - Not Found**.**

---

**Mensagem: "Resource sub not found"**  

**Possível causa**: a URL ou o recurso solicitado não está correto. **Solução**: verifique a URL e garanta que todos os parâmetros estão corretos.

---

****500 - Internal Server Error**.**

    

---

**Mensagem: "Unexpected error."**  

**Possível causa**: o erro está no servidor Segura®. **Solução**: contate o time de suporte para mais informações.

---

**Mensagem: "You are not authorized to access this resource."**

**Possível causa**: você não possui autorização para acessar esse recurso. **Solução**: solicite ao administrador que revise sua permissão de acesso aos recursos do **Usuário** no **A2A**.

---

****Client authentication failed**.**

---

**Mensagem: "Client authentication failed."**

**Possível causa**: falha na autenticação da sua aplicação com o servidor Segura®. **Solução**: verifique os parâmetros de autenticação como `Access Token URL`, `Client ID` e `Client secret` e solicite um novo token de acesso.

****Invalid signature**.**

---

**Mensagem: "Invalid signature"**

**Possível causa**: falha no reconhecimento da URL da aplicação cliente. **Solução**: verifique a URL da aplicação cliente e envie a requisição novamente.

---

****No route matched with those values**.**

    

---

**Mensagem: "No route matched with those values."**
   

**Possível causa**: ausência do header de autorização na requisição de API. **Solução**: solicite um novo token de acesso.

---

****Request timed out**.**

    

---

**Mensagem: "Request timed out."**

**Possível causa**: o tempo da requisição se esgotou. **Solução**: verifique a conectividade entre a origem da requisição e o servidor Segura®.