---
title: "GET | Listar uma senha por [identifier]"
slug: "api-get-list-a-password-by-identifier"
updated: 2026-03-04T12:05:21Z
published: 2026-03-04T14:50:13Z
canonical: "docs.senhasegura.io/api-get-list-a-password-by-identifier"
---
> ## 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 senha por [identifier]
Acesse informações de uma senha armazenada no **MySafe**.
## Pré-requisitos
- Acesso à senha no **MySafe**.
## Requisição
` GET` `api/mysafe/password/[identifier]`
## Parâmetros de requisição
Envie o parâmetro abaixo no **path** da URL.
- identifier - int - obrigatório - Código único de identificação da senha.**Nota**: este valor é automaticamente atribuído pelo Segura® em [POST | Criar senha](/v4-2/docs/pt/api-post-create-password) e é obtido na resposta da requisição [GET | Listar todas as senhas](/v4-2/docs/pt/api-get-list-all-passwords).
### Exemplo de requisição
` GET` `{{url}}api/mysafe/password/5`
## Resposta
```
HTTP/1.1 200 OK
```
```
{
"code": 200,
"response": {
"status": 200,
"message": "Success",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "Success",
"erro": false,
"cod_erro": 0
},
"password_entity": {
"identifier": "5",
"name": "gmail corporate",
"url": "www.gmail.com",
"username": "corporateuser@gmail.com",
"password": "7yha&thisismycorporatepassword78%h",
"secret_key": null,
"token": null,
"notes": "my gmail password",
"tags": "gmail",
"users_allowed": [],
"groups_allowed": []
}
}
```
### Campos do corpo da resposta
• passwords_entity - object - Dado da senha armazenada.
→ identifier - int - Código único de identificação da senha.
→ name - string - Nome da senha.
→ url - string - URL do site onde a senha está sendo utilizada.
→ username - string Nome de usuário usado para acessar a conta.
→ password - string - Senha cadastrada.
**Nota**: essa informação pode vir criptografada caso sua autorização de chave de acesso esteja configurada para criptografar dados sensíveis.
→ secret_key - string - A chave secreta fornecida para autenticação multi-fator.
→ token - string - Código TOTP gerado automaticamente pelo Segura® para autenticação multi-fator com base no token fornecido em POST | Criar senha.
→ tags - string - Palavras-chave associadas à senha.
→ users_allowed - array de objetos - Dados dos usuários com acesso à senha.
→ username - string - Nome do usuário com permissão de acesso à senha.
→ can_edit - boolean - Permissão de edição.
Atenção
Usuários com permissão `can_edit` = `true` podem inativar uma senha.
→ groups_allowed - array de objetos - Dados dos grupos com acesso à senha.
→ name - string - Nome do grupo com permissão de acesso à senha.
→ can_edit - boolean - Permissão de edição.
Atenção
Membros de grupos com permissão `can_edit` = `true` podem inativar uma senha.
## Erros
****400 - Bad Request**.**
---
**Mensagem: "1010: Unexpected identifier type"**
**Possível causa**: o `identifier` enviado não foi reconhecido como um identificador válido.
**Solução**: verifique o valor do `identifier` e envie a requisição novamente.
---
**Mensagem: "1005: Password not found"**
**Possível causa**: senha não encontrada.
**Solução**: verifique o valor do `identifier` e envie a requisição novamente.
---
**Mensagem: "1006: User does not have access"**
**Possível causa**: usuário não possui acesso à senha.
---
**Mensagem: "1009: Inactive password"**
**Possível causa**: senha inativa.
**Solução**: ative a senha através do ` POST` `api/mysafe/password/active[identifier]`.
---
****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.
---
****No route matched with those values.****
---
**Mensagem: "No route matched with those values."**
**Possíveis causas**: falha na autenticação da sua aplicação com o servidor Segura® ou URL incorreta.
**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 ou verifique e corrija a URL.
---
****An invalid response was received from the upstream server** .**
---
**Mensagem: "An invalid response was received from the upstream server**
**Possível causa**: o servidor upstream pode estar demorando muito para responder, levando a um erro de timeout que é interpretado como uma resposta inválida pelo servidor proxy/gateway.
**Solução**: verifique a conectividade entre a origem da requisição e o servidor Segura®.
---
****The upstream server is timing out**.**
---
**Mensagem: "An invalid response was received from the upstream server"**
**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®.
---