> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywise.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Release Notes

> The paywise Case Management API is regularly updated with new and improved features.

## August 2026

### August 29

* New **status update search** across all of your cases: [`GET /v1/statusupdates/`](/api-docs/case-management-api/status-updates/overview) returns a single paginated feed of every status update paywise has published to you, instead of paginating each case separately:
  * [Overview](/api-docs/case-management-api/status-updates/overview): what the feed contains, how search and filters combine, and how a result identifies its case
  * Search with `q` over the status title and the visible text of its description — HTML markup and entities in a rich-text description do not affect matching. The same parameter also matches an event code, exactly and case-insensitively. Search terms need at least three characters.
  * Filter by `mandate`, `reference_number` (current or historical, case-insensitive), `legal_stage`, `processing_state`, `created_after` and `created_before`
  * Results cover main cases **and** sub-cases. Every row carries the publishing case in `mandate` and the main case's reference in `reference_number`, because sub-cases have no reference number of their own.
  * Ordering is newest first by the business-effective date (`custom_date` where paywise supplied one, otherwise the creation timestamp), with a stable secondary order so a row never moves between pages. Up to 200 updates per page.
  * Attachment download URLs are unchanged and keep working. Entries in this collection omit `file_size`, so listing updates never triggers one storage lookup per attachment.
* No existing endpoint, field or webhook event changed.

### August 19

* New **Aktenabrechnungen** (per-case statements) endpoints available. An Aktenabrechnung settles exactly one case, alongside the existing [statements endpoint](/api-docs/case-management-api/statements/overview), which settles a whole clearing run:
  * [Overview](/api-docs/case-management-api/single-mandate-statements/overview): What an Aktenabrechnung is, how it differs from a statement, the sign convention of `total_balance`, filters and the PDF download
  * [List Aktenabrechnungen](/api-docs/case-management-api/single-mandate-statements/list-aktenabrechnungen): List all released per-case statements, filterable by case reference, your own customer number, settlement type and booking date
  * [Retrieve an Aktenabrechnung](/api-docs/case-management-api/single-mandate-statements/retrieve-an-aktenabrechnung): Retrieve a single per-case statement with its principal claims, VAT breakdown and cost burden
  * The PDF is available at `/v1/single-mandate-statements/{id}/download/full-pdf/`
* Two new webhook [event types](/api-docs/case-management-api/webhooks/event-types), `single_mandate_statement.created` and `single_mandate_statement.updated`, notify you when a per-case settlement is released to you or changes.
* No existing endpoint, field or webhook event changed.

## May 2026

### May 04

* **Webhooks** are now available. Subscribe to events and receive real-time notifications for changes to your claims, mandates, payments, statements, and requests to client. This allows you to react instantly to updates instead of polling the API:
  * [Overview](/api-docs/case-management-api/webhooks/overview): Introduction, how it works, and a quick example
  * [Event Types](/api-docs/case-management-api/webhooks/event-types): Complete list of available event types
  * [Signature Verification](/api-docs/case-management-api/webhooks/signature-verification): HMAC SHA-256 verification with Python, Node.js, and PHP examples
  * [Manage Endpoints](/api-docs/case-management-api/webhooks/manage-endpoints): API reference for creating, updating, and deleting webhook endpoints, plus test events and delivery inspection
  * [Delivery & Retries](/api-docs/case-management-api/webhooks/delivery-and-retries): Payload format, retry schedule, auto-disable behavior, and best practices

## November 2025

### November 25

* New **Request to Client** endpoints available for handling inquiries from paywise ("Rückfragen"). These endpoints allow you to fully automate the process of receiving and answering questions from paywise during the debt collection process:
  * [List requests to client](/api-docs/case-management-api/mandates/list-requests-to-client-for-a-mandate): Get all requests for a mandate, with optional filtering by answered/unanswered status
  * [Get request details](/api-docs/case-management-api/mandates/get-request-to-client-details): Retrieve full details of a specific request including file attachments
  * [Submit answer](/api-docs/case-management-api/mandates/submit-request-to-client-answer): Submit your response to a request (supports yes/no answers, free text, and file uploads depending on the request type)
  * [Upload documents](/api-docs/case-management-api/mandates/upload-document-to-request-to-client-answer): Attach document files (PDF, JPEG, PNG) to your answer

## August 2025

### August 21

* New field **related\_statements** added to the [Mandate Details endpoint](/api-docs/case-management-api/statements/list-mandate-details-for-statement): Shows all other statements containing the same mandate with their hrefs, mandate\_details\_hrefs, IDs, and clearing numbers. This allows you to track a mandate across multiple statements and see its complete history.

## May 2025

### June 04

* Added **File Download Links** for [Mandate Status Updates](/api-docs/case-management-api/mandates/list-status-updates): Download any file attachements that our status updates may have (our letters to the debtor, court documents, etc.)

### May 22

* Beta access for the new [statements endpoint](/api-docs/case-management-api/statements/overview) available. Use it to get full insight into our periodic client statements ("Abrechnungen") via the API. All the information from our statements which you receive in PDF- and Excel-format is now available. This allows for **end-to-end automation of your entire debt collection process**.

## October 2024

### October 14

* New field **send\_order\_confirmation** available for the **Release Claim for Processing** endpoint. This allows you to specify whether or not you want to receive an order confirmation for the claim you submitted. If you submit multiple claims with the same debtor at the same time it is best to only set this flag to true on the last claim to avoid receiving multiple emails.

### October 10

* New endpoint **info** available. This endpoint allows you to get details on the currently used API key in order to test successful authentication.
* Bugfix: Empty lists on the <b>claims</b> sub objects caused an error on the API. This is fixed now.

## May 2024

### May 06

* New field **legal\_claim\_balances** available for the Mandate object. This gives you information on the Legal Claim Balance of the mandate ("Forderungsstand").
* New field **further\_reference\_numbers** available for Mandate object.

## January 2024

### January 30

* Changing the type of the field **quantity** for a claim's item from Integer to Double.
* New field **unit** available for claim's items object. Use it to specify the unit used to measure the quantity of an item belonging to a claim.

### January 08

* New field **created** available for the Mandate object.
* New field **created** available for mandate's Status Update object.

## November 2023

### November 28

* New field **reference\_number** ("Aktenzeichen") available for the Mandate object.

## June 2023

### June 8

* Adding the new **payments** endpoint. Use it to create, list and retrieve payments which you received directly from your debtors.
* New field **payment** available for the claim object to allow payment object creation along with claim creation.
* New field **payment** available when retrieving Claim and Mandate objects.

## November 2022

### November 28

* Initial release