The Geldstuck API is organized around REST. It has predictable resource-oriented URLs, accepts and returns JSON, and uses standard HTTP verbs, response codes, and authentication.

​
Base URL

https://api.geldstuck.com/v1
All examples in this reference assume you’ve set your base URL and keys in environment variables: 
export GELDSTUCK_PUBLIC_KEY=pk_live_...
export GELDSTUCK_SECRET_KEY=sk_live_...

​
Request format

  • Requests use TLS 1.2+. HTTP is rejected.
  • JSON request bodies must set Content-Type: application/json.
  • Money is always minor units (cents) as an integer. 1500 EUR is €15.00, not €1500.

​
Response format

Every response has:
  • Content-Type: application/json
  • x-request-id: req_... header - include this in support tickets.
  • A JSON body. On error, the body matches the error shape.

​
Resource IDs

All IDs are prefixed with a short type tag:
PrefixResource
tnt_Tenant
usr_User
key_API key
kyc_KYC record
sof_Source-of-funds record
tx_Transaction
dr_Document review
wh_Webhook endpoint
evt_Event
file_File
IDs are 26-char ULIDs - lexicographically sortable and URL-safe.

Authentication

How to sign requests.

Errors

Full error code list.

Tenants

Create, list, retrieve tenants.

Transactions

Manage escrow lifecycles.