GET /donation-statement/$YEAR/$HASH_DONOR_ID

Get the donation statement for a specific year and donor.

Request:

Response:

200 OK:

The request was successful, and the response is a DonationStatementResponse.

204 No Content:

No donation statement exists for the given year and donor.

400 Bad Request:

The $YEAR or $HASH_DONOR_ID in the URL is malformed. Returned with error code TALER_EC_GENERIC_PARAMETER_MALFORMED.

500 Internal Server Error:

The Donau encountered an internal error, such as a database failure or signing key unavailability. Returned with error code TALER_EC_GENERIC_DB_FETCH_FAILED, TALER_EC_DONAU_GENERIC_KEYS_MISSING, or TALER_EC_DONAU_SIGNKEY_HELPER_BUG.

503 Service unavailable:

The donau is lacking the keys to create the donation statement. Returned with error code TALER_EC_DONAU_GENERIC_KEYS_MISSING.

Details:

interface DonationStatementResponse {
  total: Amount;
  // signature over h_donor_tax_id, total, donation_year
  donation_statement_sig: EddsaSignature;
  // the corresponding public key to the signature
  donau_pub: EddsaPublicKey;
}