# GNU Taler API

**Canonical:** https://apis.io/apis/gnu-taler/gnu-taler-api/  
**Provider:** GNU Taler — https://apis.io/providers/gnu-taler/  
**Base URL:** https://merchant-backend.demo.taler.net  
**Documentation:** https://docs.taler.net/core/api-apns.html

GNU Taler API is one of 2 APIs that [GNU Taler](https://apis.io/providers/gnu-taler/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

GNU Taler API as documented publicly: 176 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (60 of 176)

| Method | Path | Summary |
|---|---|---|
| GET | `/account/check` | Check account existence. |
| GET | `/accounts` | Obtains a list of the accounts registered at the bank. |
| PATCH | `/accounts` | PATCH /accounts |
| POST | `/accounts` | Create a new bank account. |
| DELETE | `/accounts/$USERNAME` | Delete the account whose username is $USERNAME. |
| PATCH | `/accounts/$USERNAME` | Update the details of a given account. |
| POST | `/admin/add-incoming` | Simulate a transfer from a customer to the exchange. |
| POST | `/admin/add-kycauth` | Simulate a transfer from a customer to the exchange. |
| POST | `/admin/add-mapped` | Simulate a transfer from a customer to the exchange. |
| GET | `/aml` | AML operations. |
| POST | `/aml` | AML operations. |
| GET | `/apt-nightly/taler-trixie-ci.sources` | GET /apt-nightly/taler-trixie-ci.sources |
| POST | `/auditors` | Enable an auditor. |
| POST | `/batch-deposit` | Deposit multiple coins from possibly different reserves into a merchant account. |
| POST | `/batch-submit` | Send in donation receipts for the current or one of the past fiscal years. |
| POST | `/blinding-prepare` | Obtain exchange-side input values in preparation for a blinding step of multiple coins for certain denomination cipher types. |
| GET | `/cashin-rate` | Calculate the exchange rate between the regional currency and the fiat currency, showing how the bank would apply the cash-in ratio and fee to one input amount. |
| GET | `/cashout-rate` | Calculate the exchange rate between the regional currency and the fiat currency, showing how the bank would apply the cash-out ratio and fee to one input amo... |
| GET | `/cashouts` | Returns the list of all cash-out operations for all accounts. |
| GET | `/charities` | GET all charities. |
| POST | `/charities` | Register a new charity with the Donau. |
| DELETE | `/charities/{charityId}` | Delete (or deactivate) a charity. |
| PATCH | `/charities/{charityId}` | Modify a charity. |
| GET | `/coins` | Retrieve information about coins. |
| GET | `/config` | Return the protocol version and configuration information about the bank. |
| GET | `/contracts` | Obtain P2P contract associated with the given contract public key. |
| POST | `/conversion-rate` | Update the global exchange rate between the regional currency and the fiat currency of the banking system. |
| DELETE | `/conversion-rate-classes` | DELETE /conversion-rate-classes |
| GET | `/conversion-rate-classes` | Get a list of all conversion rate classes available on the bank. |
| PATCH | `/conversion-rate-classes` | PATCH /conversion-rate-classes |
| POST | `/conversion-rate-classes` | Create a new conversion rate classe. |
| DELETE | `/conversion-rate-classes/{classId}` | DELETE /conversion-rate-classes/{classId} |
| GET | `/conversion-rate-classes/{classId}` | GET /conversion-rate-classes/{classId} |
| PATCH | `/conversion-rate-classes/{classId}` | PATCH /conversion-rate-classes/{classId} |
| POST | `/csr-issue` | Obtain donau-side input values in preparation for an issue receipt step for certain donation unit cipher types, specifically for Clause-Schnorr blind signatu... |
| PUT | `/deposit-confirmation` | Submits a DepositConfirmation to the auditor. |
| GET | `/deposits` | Retrieve information about deposits. |
| POST | `/devices` | Register an iOS device for recurrent wakeup. |
| DELETE | `/devices/{token}` | Unregister an iOS device. |
| GET | `/exchanges` | Return information about exchanges configured for this merchant backend. |
| GET | `/fountain/info` | Wallet fountain API endpoint for retrieving grants and withdrawing blind-signed promotional tokens. |
| GET | `/history` | Return the finalized year-end donation totals for all charities. |
| GET | `/history/incoming` | Return a list of transactions made from or to the exchange. |
| GET | `/history/outgoing` | Return a list of transactions made by the exchange, typically to a merchant. |
| GET | `/info` | Obtain the verified address of the user using an access token. |
| GET | `/instances` | Retrieve all instances. |
| POST | `/instances` | Create a new merchant instance. |
| GET | `/keys` | Get a list of all donation units keys offered by the Donau, as well as the Donau's current online signing key. |
| POST | `/kyc-bulk/$EXTERN_PUB` | Upload large KYC/KYB attachments by third parties. |
| POST | `/kyc-bulk/endpoint` | Bulk file uploads for KYC data. |
| GET | `/kyc-check/$H_NORMALIZED_PAYTO` | Checks the KYC status of a particular payment target. |
| POST | `/kyc-import/$EXTERN_PUB` | Upload KYC/KYB data by third parties. |
| GET | `/kyc-info/$ACCESS_TOKEN` | Return information about the state of the KYC or AML process to the KYC SPA. |
| GET | `/kyc-proof/$PROVIDER_NAME` | Process KYC completion callback from external KYC provider. |
| GET | `/kyc-spa/$ACCESS_TOKEN` | Serves the KYC SPA. |
| POST | `/kyc-start/$ID` | Set up a new external KYC process. |
| POST | `/kyc-upload/$ID` | Upload client-provided evidence for KYC checks. |
| POST | `/kyc-wallet` | Setup KYC identification for a wallet. Returns the KYC UUID. |
| GET | `/kyc-webhook/$PROVIDER_NAME/*` | Update KYC status via webhook from external provider. |
| POST | `/kyc-webhook/$PROVIDER_NAME/*` | Update KYC status via webhook from external provider. |

…and 116 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/gnu-taler/openapi/_ae-authored/gnu-taler-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/gnu-taler/json-schema/gnu-taler-put-deposit-confirmation-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/gnu-taler/json-schema/gnu-taler-get-monitor-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/gnu-taler/json-schema/gnu-taler-post-conversion-rate-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/gnu-taler/json-schema/gnu-taler-patch-conversion-rate-classes-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/gnu-taler/json-schema/gnu-taler-patch-conversion-rate-classes-classid-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/gnu-taler/json-schema/gnu-taler-post-conversion-rate-classes-request-schema.json

## Other GNU Taler APIs (1)

- [GNU Taler Core APIs](https://apis.io/apis/gnu-taler/gnu-taler-core-apis/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gnu-taler/gnu-taler-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gnu-taler/.