---
title: "GET | Listar todas as senhas"
slug: "api-get-list-all-passwords"
updated: 2026-11-03T14:48:14Z
published: 2026-11-03T14:48:14Z
canonical: "docs.senhasegura.io/api-get-list-all-passwords"
---
> ## 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 todas as senhas
Acesse informações de senhas armazenadas no **MySafe**.
## Requisição
` GET` `api/mysafe/password`
## Parâmetros de consulta
Envie os parâmetros abaixo como **query** na URL.
- tag - string - Filtra as senhas por tags associadas.
- name - string - Filtra as senhas pelo nome.
- username - string - Filtra as senhas pelo nome de usuário.
- url - string - Filtra as senhas pela URL associada.
### Exemplos de requisição
` GET` `{{url}}api/mysafe/password` - Lista todas as senhas.
` GET` `{{url}}api/mysafe/password?tag=gmail` - Lista a(s) senha(s) cadastradas com a `tag` = `gmail`.
` GET` `{{url}}api/mysafe/password?name=Github` - Lista a(s) senha(s) cadastradas com a `name` = `Github`.
` GET` `{{url}}api/mysafe/password?username=dleite` - Lista a(s) senha(s) cadastradas com o `username` = `dleite`.
` GET` `{{url}}api/mysafe/password?url=www.gmail.com` - Lista a(s) senha(s) cadastradas com a `url` = `www.gmail.com`.
## Resposta
```
HTTP/1.1 200 OK
```
```
{
"code": 200,
"response": {
"status": 200,
"message": "",
"error": false,
"error_code": 0,
"detail": "",
"mensagem": "",
"erro": false,
"cod_erro": 0
},
"password_on_list": [
{
"identifier": "3",
"name": "Github",
"url": "https://github.com",
"username": "deboraleitef@gmail.com",
"tags": "",
"need_justify": "0",
"need_approval": "0",
"can_view": true,
"can_write": true
},
{
"identifier": "4",
"name": "gmail personal",
"url": "www.gmail.com",
"username": "user@gmail.com",
"tags": "gmail",
"need_justify": "0",
"need_approval": "0",
"can_view": true,
"can_write": true
},
{
"identifier": "5",
"name": "gmail corporate",
"url": "www.gmail.com",
"username": "corporateuser@gmail.com",
"tags": "gmail",
"need_justify": "0",
"need_approval": "0",
"can_view": true,
"can_write": true
},
{
"identifier": "6",
"name": "Segura",
"url": "www.segura.com",
"username": "dleite",
"tags": "Segura",
"need_justify": "0",
"need_approval": "0",
"can_view": true,
"can_write": true
}
]
}
```
### Campos do corpo da resposta
• passwords_on_list - array de objetos - Dados das senhas armazenadas.
→ 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.
→ 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.
→ can_view - string - Permissão de visualização da senha.
→ can_write - string - Permissão de edição da senha.
## Erros
****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 a seupstream 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™.
---