Quickstart
5 Schritte zur ersten Forderung mit CashMich.
1. Registrieren & Email verifizieren
Erstellen Sie ein Konto auf cashmich.com/register. Bestätigen Sie Ihre E-Mail-Adresse über den Link in der Verifizierungs-Email.
2. API Key erstellen
Navigieren Sie zu Einstellungen → API Keys (/settings/api-keys). Erstellen Sie einen neuen API Key. Format: cm_live_XXXXXXXXXX. Speichern Sie den Key sicher — er wird nur einmal angezeigt.
3. CLI installieren
npm i -g cashmich
cashmich auth login --api-key cm_live_YOUR_KEY_HEREAlternativ ohne globale Installation:
npx cashmich auth login --api-key cm_live_YOUR_KEY_HERE4. Erste Forderung erstellen
Per CLI:
cashmich claims create \
--creditor-name "Ihre Firma GmbH" \
--creditor-iban "AT611904300234573201" \
--debtor-name "Max Mustermann" \
--debtor-email "max@example.com" \
--amount 250.00 \
--invoice-number "RE-2026-001"Per curl:
curl -X POST https://api.cashmich.com/api/v1/claims \
-H "Authorization: Bearer cm_live_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"creditorName": "Ihre Firma GmbH",
"creditorIban": "AT611904300234573201",
"debtorName": "Max Mustermann",
"debtorEmail": "max@example.com",
"amount": 250.00,
"invoiceNumber": "RE-2026-001"
}'5. Status prüfen
Per CLI:
cashmich claims list
cashmich claims get <claim-id>Per curl:
curl https://api.cashmich.com/api/v1/claims \
-H "Authorization: Bearer cm_live_YOUR_KEY_HERE"Ohne Anmeldung testen: Sandbox
Sie möchten die API ausprobieren, bevor Sie sich registrieren? Der Sandbox-Endpunkt gibt Ihnen sofort einen kurzlebigen API-Key (60 Minuten gültig), ganz ohne Konto:
curl -X POST https://api.cashmich.com/api/v1/sandbox/keyDie Antwort enthält apiKey (Format cm_live_…) sowie fertige curl-Beispiele. Verwenden Sie den Key wie einen echten Key:
# Key holen und direkt verwenden
KEY=$(curl -s -X POST https://api.cashmich.com/api/v1/sandbox/key | jq -r .apiKey)
# Forderung anlegen (Demo-Daten)
curl -X POST https://api.cashmich.com/api/v1/claims \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"creditorName":"Demo GmbH","creditorIban":"AT483200000012345864","debtorName":"Max Mustermann","debtorEmail":"max@example.com","amount":250}'
# Forderungen auflisten (inkl. vorgefertigter Demo-Forderungen)
curl https://api.cashmich.com/api/v1/claims \
-H "Authorization: Bearer $KEY"Wichtig zur Sandbox:
- Isoliert: Der Key gehört zu einem eigenen Demo-Mandanten und kann keine echten Daten sehen oder ändern.
- Keine echten Nachrichten: Kein Schuldner wird kontaktiert — alle E-Mails/SMS werden unterdrückt.
- Nur Lesen + Anlegen: Berechtigungen auf
claims:read+claims:createbeschränkt. - Streng limitiert: 10 Keys pro Stunde und IP, 20 Requests/Minute für die gesamte Sandbox.
- Kurzlebig: Der Key läuft nach 60 Minuten ab. Für Produktion einen echten Key erstellen (siehe Schritt 2).
Häufige Fehler
- 401 Unauthorized: API Key prüfen — Format muss
cm_live_sein. - 422 Validation Error: Pflichtfelder:
creditorName,creditorIban,debtorName,amount. - 429 Too Many Requests: Rate Limit erreicht — kurz warten und erneut versuchen.