---
title: "GET | Listar requisições"
slug: "api-clm-query-list-requests"
updated: 2026-03-04T12:05:18Z
published: 2026-03-04T14:50:13Z
canonical: "docs.senhasegura.io/api-clm-query-list-requests"
---

> ## 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 requisições

Lista requisições de certificados baseadas em filtros específicos.

- ***Endpoint***: `/api/certificate/request/list`
- **Método**: `GET`
- **Requisição**: `GET /api/certificate/request/list`

## Parâmetros da requisição

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `code_request` | `int` | Não | Código de uma requisição existente. Caso não seja inserido, uma nova requisição será criada. |
| `status_request` | `int` | Não | Código do *status* da requisição. |
| `type_certificate` | `int` | Não | Tipo de certificado. |
| `type_domain` | `string` | Não | Tipo de domínio. |
| `organization` | `int` | Não | Código da organização. |
| `common_name` | `string` | Não | Nome comum do certificado. |
| `san` | `string` | Não | Nomes alternativos do assunto (separados por vírgula). |
| `tags` | `string` | Não | *Tags* de identificação (separadas por vírgula). |
| `encryption` | `string` | Não | Algoritmo de criptografia. |
| `encryption_key_size` | `int` | Não | Tamanho da chave de criptografia. |
| `algorithm_certified` | `string` | Não | Algoritmo de assinatura. |
| `validity` | `int` | Não | Período de validade do certificado em dias. |
| `environments` | `string` | Não | Ambientes (separados por vírgula). |
| `systems` | `string` | Não | Sistemas (separados por vírgula). |
| `design` | `string` | Não | Nome do projeto. |
| `ip_external` | `string` | Não | Endereço IP externo. |
| `ip_hostname` | `string` | Não | IP ou *hostname*. |
| `responsible` | `int` | Não | Código do usuário responsável. |
| `offset` | `int` | Não | Ponto de início da paginação. |
| `limit` | `int` | Não | Número de registros por página. |

### Exemplo utilizando cURL

```
curl -X GET "https://[segura_vault_url]/api/certificate/request/list" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

### Resposta

```
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "1001: OK",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "1001: OK",
        "erro": false,
        "cod_erro": 0
    },
    "tenant": "Segura",
    "data": {
        "code_request": "1",
        "status_request": "7 - Signed",
        "type_certificate": "DV SSL - Domain SSL",
        "type_domain": "Single domain",
        "organization": "organization",
        "common_name": "api-test.com",
        "san": "api-test",
        "tags": "",
        "validity": "100",
        "encryption": "RSA",
        "encryption_key_size": "4096",
        "algorithm_certified": "sha256",
        "password_key": "api-password-key",
        "password_revocation": "api-password-revocation",
        "environments": "",
        "systems": "",
        "project": "",
        "ip_external": "",
        "ip_hostname": "",
        "justification": "API test",
        "self_signed": "true",
        "ca": "",
        "responsible": "31 - api-user",
        "description": "API test"
    }
  // Additional requests will be listed here
}
```

### Respostas de erro

| Código de status HTTP | Descrição |
| --- | --- |
| **400 Bad Request** | Parâmetros inválidos fornecidos (campos obrigatórios ausentes ou formato inválido). |
| **401 Unauthorized** | Acesso não autorizado. |
| **403 Forbidden** | Permissão negada. |
| **404 Not Found** | Recurso não encontrado. |
| **500 Internal Server Error** | Erro interno do servidor. |