taler-docs

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

get-coins-COIN_PUB-history.rst (1356B)

      1 .. http:get:: /coins/$COIN_PUB/history
      2 
      3   Obtain the transaction history of a coin.
      4 
      5   **Request:**
      6 
      7   *Coin-History-Signature*:
      8     The client must provide a Base-32 encoded EdDSA signature with
      9     the coin's private key, affirming the desire to obtain the coin's
     10     history.
     11 
     12   *If-None-Match*:
     13     The client MAY provide an ``If-None-Match`` header with an ETag.
     14 
     15   **Response:**
     16 
     17   :http:statuscode:`200 OK`:
     18     The coin is known to the exchange and the response is
     19     the coin's transaction history.
     20   :http:statuscode:`204 No content`:
     21     The coin's transaction history is empty (but the ETag changed).
     22   :http:statuscode:`403 Forbidden`:
     23     The coin history signature is invalid.
     24     This response comes with a standard `ErrorDetail` response with
     25     a code of ``TALER_EC_EXCHANGE_COIN_HISTORY_BAD_SIGNATURE``.
     26   :http:statuscode:`404 Not found`:
     27     The coin is unknown to the exchange.
     28     This response comes with a standard `ErrorDetail` response with
     29     a code of ``TALER_EC_EXCHANGE_GENERIC_COIN_UNKNOWN``.
     30   :http:statuscode:`500 Internal Server Error`:
     31     The server experienced an internal error.
     32     This response comes with a standard `ErrorDetail` response.
     33     Possible error codes include
     34     ``TALER_EC_GENERIC_DB_FETCH_FAILED``,
     35     ``TALER_EC_GENERIC_DB_SOFT_FAILURE``, or
     36     ``TALER_EC_GENERIC_JSON_ALLOCATION_FAILURE``.