# SignaturesApi.list()

```ts
list(): Promise<SignatureInfo[]>
```

Every signature's metadata — reason, signing time, sub-filter, certification level (`changesAllowed`), whether it is signed (`signed`). Says whether a document is signed and what its certification allows. A signature field nested under a parent field (a dotted name) counts too, though the document's own list of signature fields does not include it. Without the `extract` feature each `reason` is `''`. Needs no feature.

- Kind: method
- Since: 1.0.0

Returns `Promise<SignatureInfo[]>`: Each `{ index, reason, signedAt, subFilter, changesAllowed, signed }`: `reason` (`''` when absent), `signedAt` (when it was signed, as the signature says; `null` when it does not), `subFilter` (the signature's format as the file names it, `'adbe.pkcs7.detached'` …, or `''`), `changesAllowed` (`'none' | 'forms' | 'annotations'`: what the signer allowed afterwards; `null` when unsaid) and `signed` (whether it holds signature bytes, or is a field still to be signed).

Throws:

- `DOCUMENT_CLOSED` — the document has been closed.

```ts
const signed = (await doc.signatures.list()).some((s) => s.signed);
if (signed) showNotice('Changes are saved after the signed version');
```

Part of [SignaturesApi](https://kernstra.com/docs/web-sdk/api/doc-signatures) in the Kernstra Web SDK 1.0.0 API reference.

Web page: https://kernstra.com/docs/web-sdk/api/doc-signatures/list