commit aa1e9207a2399486e9d58ff65fc1eb9907ef9f31 parent 84821d3f6d695ee02e6e32853f0052347b01564c Author: Christian Grothoff <christian@grothoff.org> Date: Wed, 27 Nov 2024 15:51:33 +0100 spec for #9340 Diffstat:
| M | core/api-exchange.rst | | | 58 | ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
1 file changed, 58 insertions(+), 0 deletions(-)
diff --git a/core/api-exchange.rst b/core/api-exchange.rst @@ -5553,6 +5553,64 @@ and freeze or unfreeze accounts suspected of money laundering. } + +.. http:get:: /aml/$OFFICER_PUB/legitimizations + + Enables AML staff to see which legitimizations are pending + or have been completed. + returns a list of active or finished legitimization + measures (by account). + + This endpoint was introduced in protocol **v23**. + + **Request:** + + *Taler-AML-Officer-Signature*: + The client must provide Base-32 encoded EdDSA signature with + ``$OFFICER_PRIV``, affirming the desire to obtain AML data. Note that + this is merely a simple authentication mechanism, the details of the + request are not protected by the signature. + + **Response:** + + :http:statuscode:`200 Ok`: + Information about possible measures is returned in a + `LegitimizationMeasuresList` object. + + **Details:** + + .. ts:def:: LegitimizationMeasuresList + + interface LegitimizationMeasuresList { + + // Legitimization measures. + measures: LegitimizationMeasureDetails; + + } + + .. ts:def:: LegitimizationMeasureDetails + + interface LegitimizationMeasureDetails { + + // Hash of the normalized payto:// URI of the account the + // measure applies to. + h_payto: HashCode; + + // Row of the measure in the exchange database. + rowid: Integer; + + // When was the measure started? + start_time: Timestamp; + + // The the actual measures. + measures: LegitimizationMeasures; + + // Was this measure finished by the customer? + is_finished: boolean; + + } + + .. http:get:: /aml/$OFFICER_PUB/attributes/$H_NORMALIZED_PAYTO Obtain attributes obtained as part of AML/KYC processes for a