---
title: "GET | Listar todos os dispositivos"
slug: "api-get-list-all-devices"
updated: 2026-03-06T13:28:53Z
published: 2026-03-06T13:28:53Z
canonical: "docs.senhasegura.io/api-get-list-all-devices"
---

> ## 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 dispositivos

Acesse informações de dispositivos no **PAM Core**.

## Pré-requisitos

- Autorização com permissão de **acesso** ao **PAM Core** concedida pelo administrador no  **A2A**.  

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

Saiba mais em [POST | Criar dispositivo](/v4-2/docs/pt/api-post-create-device).

## Requisição

` GET` `/api/pam/device`

### Exemplo de requisição

` GET` `{{url}}/api/pam/device`

## Resposta

```
HTTP/1.1 200 OK
```

```
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "2 devices found",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "2 devices found",
        "erro": false,
        "cod_erro": 0
    },
    "devices": [
        {
            "id": "1",
            "hostname": "mydevicehostname",
            "ip": "172.10.20.30",
            "model": "Windows Server 2012",
            "type": "Server",
            "vendor": "Microsoft",
            "site": "LAX"
	    "tags": "tag001"
        },
        {
            "id": "6",
            "hostname": "myseconddevice",
            "ip": "41.41.208.182",
            "model": "CentOS 7",
            "type": "Server",
            "vendor": "CentOS",
            "site": "AWS"
	    "tags": ""
        }
    ]
}
```

### Campos do corpo da resposta

<summary>• <code>devices</code> - <b>array de objetos</b> - Dados dos dispositivos.</summary>

<summary>&nbsp;  &nbsp;→ <code>id</code> - <b>int</b> - Código único de identificação do dispositivo gerado automaticamente pelo Segura® em <a href="/v4-2/docs/pt/api-post-create-device" rel="noopener">POST | Criar dispositivo</a>.</summary>

<summary>&nbsp;  &nbsp;→ <code>hostname</code> - <b>string</b> - Nome do host do dispositivo.</summary>

<summary>&nbsp;  &nbsp;→ <code>ip</code> - <b>string</b> - Endereço IP do dispositivo.</summary>

<summary>&nbsp;  &nbsp;→ <code>model</code> - <b>string</b> Modelo do dispositivo .</summary>

 <summary>&nbsp;  &nbsp;→ <code>type</code> - <b>string</b> - Tipo de dispositivo.</summary>

<summary>&nbsp;  &nbsp;→ <code>vendor</code> - <b>string</b> - Fabricante do dispositivo.</summary>

<summary>&nbsp;  &nbsp;→ <code>site</code> - <b>string</b> Localização do dispositivo.</summary>

<summary>&nbsp;  &nbsp;→ <code>tags</code> - <b>string</b> - Palavras-chave associadas ao dispositivo.</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 **PAM Core** 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®.