taler-docs

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

get-private-units-UNIT.rst (633B)

      1 .. http:get:: [/instances/$INSTANCE]/private/units/$UNIT
      2 
      3   Fetch details for a single measurement unit.
      4 
      5   **Required permission:** ``units-read``
      6 
      7   **Response:**
      8 
      9   :http:statuscode:`200 OK`:
     10     The backend returned the unit definition. The body is a `MerchantUnit`.
     11   :http:statuscode:`401 Unauthorized`:
     12     The request is unauthorized.
     13   :http:statuscode:`404 Not found`:
     14     The unit is unknown to the backend.
     15     Returned with ``TALER_EC_MERCHANT_GENERIC_UNIT_UNKNOWN``.
     16   :http:statuscode:`500 Internal Server Error`:
     17     The server experienced an internal failure.
     18     Returned with ``TALER_EC_GENERIC_DB_FETCH_FAILED``.