> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar origens cadastradas no VIDaaS

> Lista todas as origens (domínios) registradas como endereços de retorno válidos no VIDaaS.

Lista todas as origens cadastradas como endereços de retorno válidos no VIDaaS para seu projeto. Use este endpoint para verificar o estado do cadastro antes de suspeitar que o VIDaaS perdeu a lista.

**Autenticação**: use uma chave de API (`x-api-key`).

## Parâmetros

Nenhum.

## Respostas

Array de objetos, cada um representando um cadastro:

<ResponseField name="uuid" type="string" required>
  Identificador do cadastro.
</ResponseField>

<ResponseField name="origin" type="string" required>
  Origem normalizada (como foi registrada).
</ResponseField>

<ResponseField name="redirectUri" type="string" required>
  URI completa de retorno (origem + caminho fixo). Exemplo: `https://assinador.cliente.com.br/sign/vidaas/callback`.
</ResponseField>

<ResponseField name="projectId" type="string" optional>
  Tenant da Platform (extraído da chave de API).
</ResponseField>

<ResponseField name="status" type="string" required>
  Status do cadastro no provedor:

  * `PENDING`: enviado ao provedor mas ainda aguardando confirmação.
  * `REGISTERED`: aceito e registrado no provedor.
  * `FAILED`: o provedor recusou o cadastro (veja `lastError`).
</ResponseField>

<ResponseField name="registeredAt" type="string" optional>
  Timestamp (ISO-8601) de quando o cadastro foi aceito pelo provedor. Presente apenas quando `status` = `REGISTERED`.
</ResponseField>

<ResponseField name="lastError" type="string" optional>
  Descrição da última falha no cadastro. Presente apenas quando `status` = `FAILED`.
</ResponseField>

## Erros

Veja [Autenticação e erros](/plataforma/assinatura-digital/api/erros-e-autenticacao).

* **401**: Chave de API inválida ou expirada.
* **403**: Origem não autorizada (raro — seu projeto está bloqueado).

<ResponseExample>
  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 200 OK
  Content-Type: application/json

  [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "origin": "https://assinador.cliente.com.br",
      "redirectUri": "https://assinador.cliente.com.br/sign/vidaas/callback",
      "projectId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "status": "REGISTERED",
      "registeredAt": "2025-07-27T10:30:00Z",
      "lastError": null
    },
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440001",
      "origin": "https://localhost:3000",
      "redirectUri": "https://localhost:3000/sign/vidaas/callback",
      "projectId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "status": "REGISTERED",
      "registeredAt": "2025-07-27T10:35:00Z",
      "lastError": null
    }
  ]
  ```

  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 401 Unauthorized
  Content-Type: application/json

  {
    "statusCode": 401,
    "message": "Invalid API Key"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X GET "https://api.valid.com/signer/v1/vidaas/redirect-uris" \
  -H "x-api-key: SEU_API_KEY"
```

## Importante

* **Autenticação por API Key**: este é um endpoint administrativo — use sua chave de API.
* **View-only**: esta operação só consulta — não cria ou altera nada.
* **Filtrado por projeto**: lista só as origens do seu projeto (extraído da chave de API).

## Próximas etapas

* Se alguma origem está com `status: FAILED`, veja o `lastError` e considere reenviar o cadastro com [`POST /signer/v1/vidaas/redirect-uris`](/plataforma/assinatura-digital/api/post-vidaas-redirect-uri) e `force: true`.
* Se está faltando uma origem que você esperava, registre-a com [`POST /signer/v1/vidaas/redirect-uris`](/plataforma/assinatura-digital/api/post-vidaas-redirect-uri).