Contents

GET /charity/$CHARITY_ID#

Request information about a specific charity. Only allowed if the request comes with a signature by the respective charity.

Request:

Charity-Signature:

The client must provide Base-32 encoded EdDSA signature with $CHARITY_PRIV, affirming the desire to obtain the charity status. Note that this is merely a simple authentication mechanism, the details of the request are not protected by the signature. The $CHARITY_PRIV is usually the merchant instance private key.

Response:

200 OK:

The Donau responds with a Charity object

404 Not found:

The charity id does not belong to a charity known to the Donau.

interface Charity {
  charity_pub: EddsaPublicKey;
  name: string;
  url: string;
  max_per_year: Amount;
  receipts_to_date: Amount;
  current_year: Integer;
}