Retrieve an Aktenabrechnung

curl --request GET \
  --url https://api.paywise.de/v1/single-mandate-statements/{id}/ \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.paywise.de/v1/single-mandate-statements/{id}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.paywise.de/v1/single-mandate-statements/{id}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.paywise.de/v1/single-mandate-statements/{id}/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.paywise.de/v1/single-mandate-statements/{id}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "href": "https://api.paywise.de/v1/single-mandate-statements/9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f/",
  "id": "9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "clearing_no": "A2026/000123",
  "invoice_no": "R2026/000456",
  "statement_type": "interim",
  "booking_date": "2026-08-18",
  "period_start": "2026-07-01",
  "period_end": "2026-08-18",
  "canceled": false,
  "comment": "Zwischenabrechnung nach Teilzahlung",
  "reference_number": "K26-757P3",
  "your_reference": "W00150540",
  "mandate": {
    "href": "https://api.paywise.de/v1/mandates/5600672e-2bfa-488c-b23a-460c1dd1f833/",
    "id": "5600672e-2bfa-488c-b23a-460c1dd1f833",
    "reference_number": "K26-757P3"
  },
  "pre_tax_deductible": true,
  "payout_method": "transfer",
  "principal_claims_total": {
    "value": "200.00",
    "currency": "EUR"
  },
  "open_principal_claim": {
    "value": "0.00",
    "currency": "EUR"
  },
  "total_balance": {
    "value": "180.00",
    "currency": "EUR"
  },
  "principal_claims": [
    {
      "voucher_no": "RE-1",
      "voucher_date": "2026-05-03",
      "amount": {
        "value": "123.45",
        "currency": "EUR"
      }
    },
    {
      "voucher_no": "RE-2",
      "voucher_date": "2026-05-04",
      "amount": {
        "value": "76.55",
        "currency": "EUR"
      }
    }
  ],
  "vat_entries": [
    {
      "vat_rate": "0.19",
      "total_payments": {
        "value": "200.00",
        "currency": "EUR"
      },
      "payments_to_dca": {
        "value": "200.00",
        "currency": "EUR"
      },
      "payments_to_client": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_main_claim": {
        "value": "180.00",
        "currency": "EUR"
      },
      "allocation_to_default_interest": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_client_expenses": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_client_costs": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_overpayment": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_tax_free_expenses": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_taxable_expenses": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_taxable_expenses_vat": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_fee": {
        "value": "16.81",
        "currency": "EUR"
      },
      "allocation_to_fee_vat": {
        "value": "3.19",
        "currency": "EUR"
      },
      "allocation_to_success_commission": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_success_commission_vat": {
        "value": "0.00",
        "currency": "EUR"
      },
      "instalment_payments_to_client": {
        "value": "0.00",
        "currency": "EUR"
      },
      "payout": {
        "value": "180.00",
        "currency": "EUR"
      }
    }
  ],
  "cost_burden": null,
  "downloads": [
    {
      "id": "1d1eb5ba-2a3c-5f78-9c11-6b3f0d5a7e42",
      "type": "full_pdf",
      "filename": "aktenabrechnung_A2026-000123.pdf",
      "mime_type": "application/pdf",
      "file_size": 42317,
      "download_url": "https://api.paywise.de/v1/single-mandate-statements/9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f/download/full-pdf/"
    }
  ],
  "created": "2026-08-18T09:12:44.512300Z"
}

Single Mandate Statements

Retrieve an Aktenabrechnung

An Aktenabrechnung settles exactly one case. It is created by a case event in our collection system and becomes available here once we have released it.

Not the same resource as /v1/statements/. A statement (Sammelabrechnung) settles every case of one clearing run at once and carries a mandate_details sub-resource; an Aktenabrechnung settles a single case and carries that case directly in mandate. Both number ranges are shared, so the same clearing_no never appears in both resources.

Types (statement_type):

Value	Meaning
`interim`	Zwischenabrechnung — interim settlement while the case continues
`final`	Endabrechnung — final settlement of the case
`expenses_invoice`	Auslagenrechnung — invoice for expenses we advanced
`transition_to_longtime_monitoring`	Übergabe Überwachungsverfahren — handover to long-term monitoring
`negative_closing`	Negativabschluss — the case is closed without success

Sign convention. total_balance is the authority on the direction of the money: a positive value is a payout to you, a negative value is an amount you owe us. A negative balance is itemised in cost_burden; a payout is itemised in vat_entries. Do not infer the direction from statement_type — an interim settlement can end up negative.

reference_number is our case reference, your_reference is your own customer number for the debtor as it was stored on the case. vat_rate is a decimal fraction (0.19 = 19%), the same convention as overview_vat_specific on /v1/statements/.

Subscribe to the single_mandate_statement.created and single_mandate_statement.updated webhook events instead of polling. created fires when we release an Aktenabrechnung to you, not when it is first booked internally, so every statement a webhook announces is retrievable here.

GET

single-mandate-statements

{id}

Retrieve an Aktenabrechnung

curl --request GET \
  --url https://api.paywise.de/v1/single-mandate-statements/{id}/ \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.paywise.de/v1/single-mandate-statements/{id}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.paywise.de/v1/single-mandate-statements/{id}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.paywise.de/v1/single-mandate-statements/{id}/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.paywise.de/v1/single-mandate-statements/{id}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "href": "https://api.paywise.de/v1/single-mandate-statements/9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f/",
  "id": "9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "clearing_no": "A2026/000123",
  "invoice_no": "R2026/000456",
  "statement_type": "interim",
  "booking_date": "2026-08-18",
  "period_start": "2026-07-01",
  "period_end": "2026-08-18",
  "canceled": false,
  "comment": "Zwischenabrechnung nach Teilzahlung",
  "reference_number": "K26-757P3",
  "your_reference": "W00150540",
  "mandate": {
    "href": "https://api.paywise.de/v1/mandates/5600672e-2bfa-488c-b23a-460c1dd1f833/",
    "id": "5600672e-2bfa-488c-b23a-460c1dd1f833",
    "reference_number": "K26-757P3"
  },
  "pre_tax_deductible": true,
  "payout_method": "transfer",
  "principal_claims_total": {
    "value": "200.00",
    "currency": "EUR"
  },
  "open_principal_claim": {
    "value": "0.00",
    "currency": "EUR"
  },
  "total_balance": {
    "value": "180.00",
    "currency": "EUR"
  },
  "principal_claims": [
    {
      "voucher_no": "RE-1",
      "voucher_date": "2026-05-03",
      "amount": {
        "value": "123.45",
        "currency": "EUR"
      }
    },
    {
      "voucher_no": "RE-2",
      "voucher_date": "2026-05-04",
      "amount": {
        "value": "76.55",
        "currency": "EUR"
      }
    }
  ],
  "vat_entries": [
    {
      "vat_rate": "0.19",
      "total_payments": {
        "value": "200.00",
        "currency": "EUR"
      },
      "payments_to_dca": {
        "value": "200.00",
        "currency": "EUR"
      },
      "payments_to_client": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_main_claim": {
        "value": "180.00",
        "currency": "EUR"
      },
      "allocation_to_default_interest": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_client_expenses": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_client_costs": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_overpayment": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_tax_free_expenses": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_taxable_expenses": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_taxable_expenses_vat": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_fee": {
        "value": "16.81",
        "currency": "EUR"
      },
      "allocation_to_fee_vat": {
        "value": "3.19",
        "currency": "EUR"
      },
      "allocation_to_success_commission": {
        "value": "0.00",
        "currency": "EUR"
      },
      "allocation_to_success_commission_vat": {
        "value": "0.00",
        "currency": "EUR"
      },
      "instalment_payments_to_client": {
        "value": "0.00",
        "currency": "EUR"
      },
      "payout": {
        "value": "180.00",
        "currency": "EUR"
      }
    }
  ],
  "cost_burden": null,
  "downloads": [
    {
      "id": "1d1eb5ba-2a3c-5f78-9c11-6b3f0d5a7e42",
      "type": "full_pdf",
      "filename": "aktenabrechnung_A2026-000123.pdf",
      "mime_type": "application/pdf",
      "file_size": 42317,
      "download_url": "https://api.paywise.de/v1/single-mandate-statements/9f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f/download/full-pdf/"
    }
  ],
  "created": "2026-08-18T09:12:44.512300Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Response

200 - application/json

A settlement for exactly one case (Aktenabrechnung).

Never exposes the platform-internal fields ikaros_event_id, ikaros_event_code, published and send_by_email: the first two are Ikaros bookkeeping, and the latter two are staff release decisions. A client only ever sees published Aktenabrechnungen, so published would be the constant true — a field that can only hold one value is not information, it is a promise we would have to keep.

href

string<uri>

required

read-only

URL of this Aktenabrechnung.

string<uuid>

required

read-only

Unique ID of this Aktenabrechnung.

clearing_no

string

required

read-only

The clearing number of the statement (Abrechnungsnummer). Drawn from the same number range as the clearing numbers of /v1/statements/.

invoice_no

string | null

required

read-only

The invoice number of the statement (Rechnungsnummer). Null when the settlement did not produce an invoice.

statement_type

enum<string>

required

What kind of settlement this is: "interim" (Zwischenabrechnung), "final" (Endabrechnung), "expenses_invoice" (Auslagenrechnung), "transition_to_longtime_monitoring" (Übergabe Überwachungsverfahren) or "negative_closing" (Negativabschluss).

interim - Zwischenabrechnung
final - Endabrechnung
expenses_invoice - Auslagenrechnung
transition_to_longtime_monitoring - Übergabe Überwachungsverfahren
negative_closing - Negativabschluss

Available options:

interim,

final,

expenses_invoice,

transition_to_longtime_monitoring,

negative_closing

booking_date

string<date>

required

read-only

The date the statement was booked (Buchungsdatum).

period_start

string<date> | null

required

read-only

Start of the settled period. Null for settlements that cover the whole case history.

period_end

string<date>

required

read-only

End of the settled period.

canceled

boolean

required

read-only

Whether this statement has been reversed (Storno). The reversed statement itself stays retrievable; the reversal is booked as its own statement.

comment

string | null

required

read-only

Additional comment or notes on the statement.

reference_number

string

required

read-only

Our case file reference number ("Aktenzeichen") of the case this statement settles.

your_reference

string | null

required

read-only

Your customer number of the debtor as stored on the case

mandate

object | null

required

The case this statement settles. Null when the case is no longer linked; use reference_number, which is a snapshot and always present.

Show child attributes

pre_tax_deductible

boolean

required

read-only

Whether you are entitled to deduct input tax (vorsteuerabzugsberechtigt). Determines whether VAT amounts are passed on to you.

payout_method

required

How the balance is settled: "transfer" (Überweisung) or "direct_debit" (Lastschrift).

transfer - Überweisung
direct_debit - Lastschrift

Available options:

transfer,

direct_debit

principal_claims_total

object | null

required

Total of all principal claims settled here (Summe der Hauptforderungen).

Show child attributes

open_principal_claim

object | null

required

Principal claim still open after this settlement (offene Hauptforderung).

Show child attributes

total_balance

object | null

required

positive = payout to you, negative = amount you owe

Show child attributes

principal_claims

object[]

required

read-only

The invoices settled by this statement (Hauptforderungen).

Show child attributes

vat_entries

object[]

required

read-only

Payments and their allocation, one entry per VAT rate.

Show child attributes

cost_burden

object | null

required

What you owe us on this case (Kostenbelastung). Null when the settlement pays out to you.

Show child attributes

downloads

object[]

required

read-only

Available files for this statement with metadata and download URLs. Empty until the PDF has been transferred.

Show child attributes

created

string<date-time>

required

read-only

Integrations

Case Management API

Partner API

Retrieve an Aktenabrechnung

Authorizations

Path Parameters

Response