--- title: "GET | Listar um dispositivo por [id]" slug: "api-get-list-a-device" updated: 2026-03-04T12:05:17Z published: 2026-03-04T14:50:13Z canonical: "docs.senhasegura.io/api-get-list-a-device" --- > ## 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 dispositivo por [id] Acesse informações de um dispositivo registrado 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). - Dispositivo criado no **PAM Core**. Saiba mais em [POST | Criar dispositivo](/v4-2/docs/pt/api-post-create-device). ## Requisição `GET` `/api/pam/device/[id]` ## Parâmetros de requisição Envie o parâmetro abaixo no **path** da URL. id - int - obrigatório - Código único de identificação do dispositivo. **Nota**: esse valor é automaticamente atribuído pelo Segura® em [POST | Criar dispositivo](/v4-2/docs/pt/api-post-create-device) e é obtido na resposta da requisição [GET | Listar todos os dispositivos](/v4-2/docs/pt/api-get-list-all-devices). ### Exemplo de requisição `GET` `{{url}}/api/pam/device/14` ## Resposta ``` HTTP/1.1 200 OK ``` ``` { "code": 200, "response": { "status": 200, "message": "Device 14", "error": false, "error_code": 0, "detail": "", "mensagem": "Device 14", "erro": false, "cod_erro": 0 }, "tenant": "Segura", "device": { "id": "14", "hostname": "API device", "ip": "10.66.33.17", "model": "Gmail", "type": "Desktop", "vendor": "Linux", "site": "AWS", "device_domain": "my_device_domain", "connectivities": "HTTP:80, SSH:22"", "session_remote_config": "HTTP::", "device_tags": "test" } } ``` ### Campos do corpo da resposta • devices - objeto - Dados do dispositivo.     → id - int - Código único de identificação do dispositivo.


    → hostname - string - Nome do host do dispositivo.


    → ip - string - Endereço IP do dispositivo.


    → model - string Modelo do dispositivo .


    → type - string - Tipo de dispositivo.


    → vendor - string - Fabricante do dispositivo.


    → site - string Localização do dispositivo.


    →device_domain - string - Nome ou abreviação do dispositivo.


    →connectivities - string - Conectividade do dispositivo.


    →session_remote_config - string - Expressão de login.


    →device_tags - string - Palavras-chave associadas ao dispositivo.


Erros

400 - Bad Request

Mensagem: "1011: Device not found"


Possível causa: dispositivo não encontrado.

Solução: verifique o valor do id 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 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®.