taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

get-donation-statement-YEAR-HASH_DONOR_ID.rst (906B)

      1 .. http:GET:: /donation-statement/$YEAR/$HASH_DONOR_ID
      2 
      3   Get the donation statement for a specific year and donor.
      4 
      5   **Request:**
      6 
      7   **Response:**
      8 
      9   :http:statuscode:`200 OK`:
     10     The request was successful, and the response is a `DonationStatementResponse`.
     11   :http:statuscode:`403 Forbidden`:
     12     One of the signatures is invalid. This response comes with a standard `ErrorDetail` response.
     13   :http:statuscode:`404 Not found`:
     14     Either the donor or the year or the corresponding donation statement was not found.
     15     This response comes with a standard `ErrorDetail` response.
     16 
     17   **Details:**
     18 
     19   .. ts:def:: DonationStatementResponse
     20 
     21     interface DonationStatementResponse {
     22       total: Amount;
     23       // signature over h_donor_tax_id, total, donation_year
     24       donation_statement_sig: EddsaSignature;
     25       // the corresponding public key to the signature
     26       donau_pub: EddsaPublicKey;
     27     }