Retrieve an Aktenabrechnung

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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));

using RestSharp;


var options = new RestClientOptions("https://api.paywise.de/v1/single-mandate-statements/{id}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "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"
}

Frozen v1 · 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

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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));

using RestSharp;


var options = new RestClientOptions("https://api.paywise.de/v1/single-mandate-statements/{id}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "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"
}

This page documents a frozen v1 API. It receives only critical correctness or security corrections. For new integrations, use the current API and follow the linked migration guide.

Autorisierungen

Authorization

string

header

erforderlich

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

Pfadparameter

string

erforderlich

Antwort

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>

erforderlich

read-only

URL of this Aktenabrechnung.

string<uuid>

erforderlich

read-only

Unique ID of this Aktenabrechnung.

clearing_no

string

erforderlich

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

erforderlich

read-only

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

statement_type

enum<string>

erforderlich

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

Verfügbare Optionen:

interim,

final,

expenses_invoice,

transition_to_longtime_monitoring,

negative_closing

booking_date

string<date>

erforderlich

read-only

The date the statement was booked (Buchungsdatum).

period_start

string<date> | null

erforderlich

read-only

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

period_end

string<date>

erforderlich

read-only

End of the settled period.

canceled

boolean

erforderlich

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

erforderlich

read-only

Additional comment or notes on the statement.

reference_number

string

erforderlich

read-only

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

your_reference

string | null

erforderlich

read-only

Your customer number of the debtor as stored on the case

mandate

object | null

erforderlich

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

erforderlich

read-only

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

payout_method

erforderlich

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

transfer - Überweisung
direct_debit - Lastschrift

Verfügbare Optionen:

transfer,

direct_debit

principal_claims_total

object | null

erforderlich

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

Show child attributes

open_principal_claim

object | null

erforderlich

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

Show child attributes

total_balance

object | null

erforderlich

positive = payout to you, negative = amount you owe

Show child attributes

principal_claims

object[]

erforderlich

read-only

The invoices settled by this statement (Hauptforderungen).

Show child attributes

vat_entries

object[]

erforderlich

read-only

Payments and their allocation, one entry per VAT rate.

Show child attributes

cost_burden

object | null

erforderlich

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

Show child attributes

downloads

object[]

erforderlich

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>

erforderlich

read-only

Mahnservice

Verwaltung

Frozen v1 · Retrieve an Aktenabrechnung

Autorisierungen

Pfadparameter

Antwort