---
title: "GET | Listar um usuário relacionado"
slug: "api-get-list-a-related-user"
updated: 2026-03-06T13:13:57Z
published: 2026-03-06T13:13:57Z
canonical: "docs.senhasegura.io/api-get-list-a-related-user"
---

> ## 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 um usuário relacionado

Acesse informações de um usuário relacionado 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/[id]`

## Parâmetros de requisição

Envie o parâmetro abaixo no **path** da requisição.

<summary><code>id</code> - <b>int</b> - <span style="color:red">obrigatório</span> - Código único de identificação do usuário relacionado.</summary>
**Nota**: Esse valor é automaticamente atribuído pelo Segura® em [POST | Criar usuário relacionado](/v4-2/docs/pt/api-post-create-related-user) e é obtido na resposta da requisição [GET | Listar todos os usuários relacionados](/v4-2/docs/pt/api-get-list-all-related-users).

### Exemplo de requisição

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

## Resposta

```
HTTP/1.1 200 OK
```

```
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "",
        "erro": false,
        "cod_erro": 0
    },
    "relatedUsers": {
        "id": "4",
        "name": "deboraleite",
        "username": "dleite"
    }
}
```

### Campos do corpo da resposta

<summary>• <code>relatedUsers</code> - <b>object</b> - Dados do usuário relacionado.</summary>

<summary>&nbsp;  &nbsp;→ <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>&nbsp;  &nbsp;→ <code>name</code> - <b>string</b> -  Nome atribuído ao usuário relacionado</summary>.

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

## Erros

****400 - Bad Request****

---

**Mensagem: "1005: User does not exist"**

**Possível causa**: o `id` informado não encontrou um usuário cadastrado no Segura®.

**Solução**: informe um `id` válido e envie a requisição novamente.

---

****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ários** 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®.