Einführung
Mit der Micgram-API greifen Sie programmatisch auf Ihre Konten, Ordner und Transaktionen zu. Die API folgt REST-Prinzipien, nutzt JSON und Standard-HTTP-Statuscodes.
Basis-URL: https://finance.micgram.de/api/v1
Hinweis: Die API ist im Enterprise-Tarif enthalten und befindet sich derzeit in der Beta.
Authentifizierung
Authentifizieren Sie sich mit einem API-Schlüssel, den Sie unter Profil → API-Zugang erzeugen. Übergeben Sie ihn im Authorization-Header:
curl https://finance.micgram.de/api/v1/accounts \
-H "Authorization: Bearer mf_live_xxxxxxxxxxxxxxxx"Bewahren Sie API-Schlüssel sicher auf und teilen Sie sie niemals in öffentlichem Code.
Endpunkte
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /accounts | Alle Konten auflisten |
| POST | /accounts | Neues Konto anlegen |
| GET | /accounts/{id} | Einzelnes Konto abrufen |
| PUT | /accounts/{id} | Konto aktualisieren |
| DELETE | /accounts/{id} | Konto löschen |
| GET | /accounts/{id}/transactions | Transaktionen eines Kontos |
| POST | /transactions | Transaktion buchen |
| GET | /folders | Ordnerstruktur abrufen |
| GET | /net-worth | Gesamtvermögen in Basiswährung |
| GET | /rates | Aktuelle Kurse |
Beispiel: Konto anlegen
Anfrage:
POST /api/v1/accounts
Content-Type: application/json
{
"name": "Tagesgeld",
"unit": "EUR",
"balance": 5000.00,
"folderId": "fld_8f2a1c"
}Antwort 201 Created:
{
"id": "acc_3d9e7b",
"name": "Tagesgeld",
"unit": "EUR",
"balance": 5000.00,
"folderId": "fld_8f2a1c",
"source": "api",
"createdAt": "2026-10-09T14:32:00Z"
}Fehlercodes
| Status | Bedeutung |
|---|---|
400 | Ungültige Anfrage – Parameter fehlen oder sind fehlerhaft |
401 | Nicht authentifiziert – API-Schlüssel fehlt oder ist ungültig |
404 | Ressource nicht gefunden |
429 | Zu viele Anfragen – Limit: 120 Anfragen pro Minute |
500 | Serverfehler – bitte später erneut versuchen |