---
title: "GET | Listar uma sessão remota por [id]"
slug: "api-get-list-a-remote-session"
updated: 2026-03-04T12:05:17Z
published: 2026-03-04T14:50:13Z
canonical: "docs.senhasegura.io/api-get-list-a-remote-session"
---

> ## 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 uma sessão remota por [id]

Acessa informações de uma sessão proxy registrada no **PAM Core** a partir do `id` da sessão.

## Requisitos

- Autorização com permissão de acesso ao **PAM Core**.
- Sessões remotas iniciadas no **PAM Core.**

## Requisição

          Alerta

          

Para realizar a listagem de uma sessão através do seu `id`, é necessário que o usuário tenha permissão de acesso para **Credentials and Devices** na autorização.

```
GET api/pam/session/remotesessions/[id]
```

## Parâmetros da requisição

          Info

          

O valor do campo `id` é atribuído automaticamente pelo Segura® no momento de criação da sessão e é obtido na resposta da requisição.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | Inteiro | Sim | Código único de identificação da sessão. |

## Exemplo de requisição

```
GET {{url}}/api/session/remotesessions/{id}
```

```
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "",
        "erro": false,
        "cod_erro": 0
    },
    "tenant": "Segura",
    "remote_session": [
        {
            "id": "30",
            "user": "MFASenhaSegura",
            "origin_ip": "172.16.20.158",
            "credential": "usrsudonopass",
            "device": "10.66.33.17:22",
            "protocol": "ssh",
            "proxy": "Web Proxy",
            "session_id": "df06257a1eb71ddf9e584d57a83a7eee9104dc43",
            "start": "2024-05-15 17:37:53",
            "end": "2024-05-15 17:38:00",
            "time": "00:00:07",
            "prevent_purge": "No",
            "request": null,
            "ITSM": null
        }
    ]
}
```

## Campos do corpo da resposta

          Info

          

- O valor para `id` é atribuído automaticamente pela plataforma Segura® no momento de criação da sessão e não deve ser confundido com o parâmetro `session_id`.
- O identificador `session_id` é usado internamente pela aplicação para operações relacionadas à sessão, tais como controle de acesso, rastreamento de atividades e gerenciamento de recursos. Cada vez que uma sessão é iniciada, um novo `session_id` é gerado para essa sessão específica.

| Campo | Tipo | Descrição | Exemplo |
| --- | --- | --- | --- |
| `remote_sessions` | Array de objetos | Dados das sessões remotas listadas. | - |
| `id` | Inteiro | Código único de identificação da sessão remota. | - |
| `user` | String | Nome de usuário utilizado para autenticação. | - |
| `origin_ip` | String | Endereço IP do dispositivo de origem da sessão. | - |
| `credential` | String | Credencial usada para realizar a sessão. | - |
| `device` | String | Nome do *host* ou endereço IP do dispositivo de destino. | - |
| `protocol` | String | Protocolo de rede (SSH, RDP, HTTPS, entre outros). | - |
| `proxy` | String | Tipo de sessão proxy. | - |
| `session_id` | String | *Hash* único gerado pelo Segura® para identificar exclusivamente uma sessão específica. | `e7acacb6aedbab70073456da5744166939b77527` |
| `start` | String | Data e hora de início da sessão em formato ISO 8601. | `2024-05-06 16:05:07` |
| `end` | String | Data e hora de término da sessão em formato ISO 8601. | `2024-05-06 16:07:59` |
| `time` | String | Duração da sessão. | `00:02:52` |
| `prevent_purge` | String | Indica se haverá a exclusão automática dos dados de uma sessão. | `No` |
| `request` | String | Solicitação feita pelo usuário. | - |
| `ITSM` | String | Código do *software* ITSM. | - |

## Erros mais comuns

| Código HTTP | Erro | Mensagem | Possível Causa | Solução |
| --- | --- | --- | --- | --- |
| 400 | Bad Request | **"1002: Session not found"** | Sessão não encontrada. | Verifique o `id` enviado para buscar pela sessão e envie a requisição novamente. |
| 404 | Not Found | **"Resource sub not found"** | A URL ou o recurso solicitado não está correto. | Verifique a URL e envie a requisição novamente. |
| 500 | Internal Server Error | **"Unexpected error."** | O erro está no servidor. | Contate o time de suporte para mais informações. |
| - | Authorization Error | **"You are not authorized to access this resource"** | Você não possui autorização para acessar esse recurso. | Solicite ao administrador que revise sua permissão de acesso aos recursos do **PAM Core** no **A2A.** |
| - | Client authentication failed | **"Client authentication failed"** | Falha na autenticação da sua aplicação com o servidor. | Verifique os parâmetros de autenticação como `Access Token`, `Client ID` e `Client secret` e solicite um novo token de acesso. |
| - | No route matched with those values | **"No route matched with those values"** | Ausência do header de autorização na requisição de API. | Solicite um novo *token* de acesso. |
| - | Request timed out | **"Request timed out"** | O tempo da requisição se esgotou. | Verifique a conectividade entre a origem da requisição e o servidor. |