---
title: "List signing processes of the calling tenant."
method: GET
path: "/epost/signing/processes"
tags: ["ePost Sign"]
---

# List signing processes of the calling tenant.

`GET /epost/signing/processes`

## Request

- Base URL: `https://api.klara.ch`
- URL: `https://api.klara.ch/epost/signing/processes`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Returns a lightweight page of signing processes belonging to the calling tenant: creator, title, optional description, status, deadline and creation timestamp. Use <code>GET /signing/processes/{processId}</code> for the full view. Access requires the ePost Sign widget subscription.

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'EXPIRED' | 'CANCELLED'

## Response `200`

A page of signing processes.

- SigningProcessListResponse
  - `items` object[]: Page of signing processes belonging to the calling tenant.
    - `processId` string, uuid: Unique identifier of the signing process.
    - `submittedBy` object: Who the signing request came from (creator).
      - `pid` string, nullable: Internal ePost id of the resolved tenant. <code>null</code> while the tenant cannot yet be resolved (e.g. forced onboarding pending).
      - `name` string, nullable: Name as used within the signing process / signature itself (verified name applied at signing). <code>null</code> while unresolved.
    - `title` string: Title of the signing request.
    - `description` string, nullable: Optional description.
    - `status` object: Current lifecycle status.
    - `deadline` string, date: Signing deadline (ISO 8601).
    - `createdAt` string, date-time: Creation timestamp (ISO 8601).
  - `total` integer: Total number of signing processes matching the filter, across all pages.

## Other responses

- `401`: No Authorization header found or invalid token<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `403`: ePost Sign widget not subscribed.<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `429`: API rate limit exceeded<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `500`: Something went wrong on our side while processing the request. Please kindly contact our support.<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.

---

[API](https://skmtc.dev/klara/apis/klara-public-api.md) · [All operations](https://skmtc.dev/klara/apis/klara-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/klara/apis/klara-public-api/revisions/490b1a879fc2?raw)