---
title: "Listar sessões de confiança"
method: GET
path: "/v1/trust-sessions"
tags: ["TrustSessions"]
---

# Listar sessões de confiança

`GET /v1/trust-sessions`

## Request

- Base URL: `https://api.signdocs.com.br`
- URL: `https://api.signdocs.com.br/v1/trust-sessions`
- Auth: HTTP bearer

Retorna uma lista paginada de Sessões de Confiança filtradas por status.

Requer scope `transactions:read`.

## Query parameters

- `status` 'ACTIVE' | 'COMPLETED' | 'CANCELLED' | 'EXPIRED' | 'FAILED', required: Status da sessão de assinatura.
- `limit` integer
- `cursor` string

## Response `200`

Lista de sessões retornada com sucesso.

- TrustSessionListResponse: Resposta da listagem de Sessões de Confiança.
  - `sessions` SigningSessionSummary[], required
    - `sessionId` string, required
    - `transactionId` string, required
    - `status` 'ACTIVE' | 'COMPLETED' | 'CANCELLED' | 'EXPIRED' | 'FAILED', required: Status da sessão de assinatura.
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time, required
    - `locale` string, required
  - `nextCursor` string: Cursor para a próxima página. Ausente se não houver mais resultados.

## Other responses

- `400`: Requisição inválida — parâmetros ausentes ou malformados.
- `401`: Autenticação ausente ou inválida.
- `403`: Permissões insuficientes para a operação solicitada. Inclui `purpose: "ACTION_AUTHENTICATION"` sem `featureFlags.trustSessionsEnabled`. A verificação é pelo `purpose`, não pela rota: vale em `/v1/transactions`, `/v1/signing-sessions` e `/v1/envelopes/{envelopeId}/sessions`, além de `/v1/trust-sessions`. O remédio é habilitar a flag para o tenant e provisionar a cota `monthlyTrustSessions`.
- `500`: Erro interno do servidor.

---

[API](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api.md) · [All operations](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/revisions/2d3805aed161?raw)