Wallet REST API

Lisez et gérez vos données financières

Lisez et gérez vos données Wallet — transactions, comptes, budgets et plus — depuis Excel, Power BI, des scripts et des outils d’automatisation via une API REST sécurisée.

Référence API complèteOpenAPI spec
Wallet REST API
GET
https://rest.budgetbakers.com/wallet
/v1/api/records?limit=30
Response:
{
"records": [
{
"id": "3643bf2e-…",
"counterParty": "Billa",
"amount": { "value": -612, "currencyCode": "CZK" },
"recordDate": "2026-06-09T11:09:00Z",
"category": { "name": "Groceries", … },
"recordType": "expense",
"paymentType": "debit_card"
}, …
]
}

Pour commencer

1

Obtenez Wallet Premium

L'API REST est disponible pour les abonnés Wallet Premium. Mettez à niveau votre compte pour débloquer l'accès à l'API.

2

Générez votre token API

Rendez-vous dans les Paramètres de l’application web Wallet et générez votre jeton API personnel. Gardez-le en sécurité — il donne accès à vos données.

3

Faites votre première requête

Utilisez l’URL de base et votre jeton pour interroger vos données financières — essayez-le en direct dans l’explorateur d’API interactif.

Données disponibles

Accès complet en lecture à tout — et création, mise à jour et suppression là où ça compte.

Données financières principales

GETPOSTPATCH/v1/api/records

Records

Transactions avec filtres avancés — créez jusqu’à 20 et mettez à jour jusqu’à 10 par requête

GETPOSTPATCH/v1/api/accounts

Accounts

Comptes bancaires, cartes et espèces — lister, en ouvrir de nouveaux, renommer et mettre à jour

GETPOSTPATCH/v1/api/categories

Categories

L’arborescence des catégories — ajoutez des sous-catégories personnalisées et renommez les vôtres

Planification et organisation

GETPOSTPATCH/v1/api/budgets

Budgets

Définitions et suivi des budgets — créez-les et ajustez-les

GET/v1/api/goals

Goals

Objectifs d’épargne et progression

GET/v1/api/standing-orders

Standing Orders

Paiements récurrents — /items liste les occurrences générées

GETPOSTPATCH/v1/api/labels

Labels

Étiquettes de transactions — lister, créer, renommer et recolorer

GET/v1/api/record-rules

Record Rules

Règles de catégorisation automatique

Maintenance et surveillance

GET/v1/api/{type}/references

Entity References

Recherche par lots des entités liées — une vérification sûre avant suppression

DELETE/v1/api/{type}

Delete Entities

Supprimez jusqu’à 10 enregistrements, budgets, comptes, étiquettes et plus par requête

GET/v1/api/api-usage/stats

API Usage Stats

Surveillez votre utilisation de l’API et le quota restant

Concepts clés

Pagination

Contrôlez les ensembles de résultats avec les paramètres limit et offset.

  • limit — jusqu’à 200 résultats par requête (30 par défaut)
  • offset — ignore N résultats
  • nextOffset — renvoyé quand il reste des résultats

Filtrage

Utilisez des préfixes typés pour filtrer les données avec précision.

  • eq., contains., contains-i. — filtres de texte
  • gt., gte., lt., lte. — comparaisons de plages
  • Répétez un filtre (jusqu’à 2×) pour des plages AND

Limites et en-têtes

Limitation token-bucket autorisant de courtes rafales, avec des en-têtes HTTP clairs.

  • 300 requêtes par heure et par client
  • X-RateLimit-Limit, X-RateLimit-Remaining
  • 429 + Retry-After en cas de dépassement

Écritures par lots

Écrivez par petits lots prévisibles — les éléments sont traités indépendamment.

  • POST /records — jusqu’à 20 éléments
  • PATCH — jusqu’à 10 éléments
  • DELETE — jusqu’à 10 ID

Bon à savoir

Conversion de devises

L’API REST exploite automatiquement les taux de change historiques pour les opérations multi-devises. La conversion suit une approche « best-effort » — les taux proviennent de données de marché publiques et peuvent différer légèrement des taux bancaires ou de change.

Totaux et tri

withTotal=true renvoie le nombre total de correspondances avec la page ; sortBy trie selon tout champ pris en charge (+ croissant, - décroissant).

État de synchronisation

Votre premier jeton API déclenche une synchronisation initiale (les requêtes renvoient 409 jusqu’à la fin). Ensuite, les en-têtes X-Last-Data-Change-At et X-Sync-In-Progress indiquent la fraîcheur des données.

Succès partiel (HTTP 207)

Les éléments d’un lot sont traités indépendamment — les résultats mixtes renvoient un récapitulatif par élément. Ajoutez validation=strict pour échouer rapidement à la place.

Exemples d'intégration

curl

Le moyen le plus simple de tester l'API depuis votre terminal.

curl -X GET "https://rest.budgetbakers.com/wallet/v1/api/records?limit=30" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Excel via Power Query

Importez des transactions directement dans Excel pour des analyses et rapports personnalisés.

  1. 1.Ouvrez Excel → Données → Obtenir des données → À partir du web
  2. 2.Entrez : https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Ajoutez l'en-tête Authorization avec votre Bearer token
  4. 4.Transformez et chargez les données dans votre feuille de calcul

Power BI Dashboard

Créez des tableaux de bord financiers en temps réel avec actualisation automatique des données.

  1. 1.Utilisez le connecteur Web dans Power BI Desktop
  2. 2.URL : https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Configurez l'authentification Bearer token
  4. 4.Configurez l'actualisation planifiée et créez des visualisations

Analyse Python

Analysez vos données financières de manière programmatique avec Python.

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}
params = {
    'recordDate': 'gte.2025-01-01',
    'limit': 100
}

response = requests.get(
    'https://rest.budgetbakers.com/wallet/v1/api/records',
    headers=headers,
    params=params
)

data = response.json()
for rec in data['records']:
    amount = rec['amount']
    print(f"{rec['recordDate'][:10]} {rec['counterParty']}: "
          f"{amount['value']} {amount['currencyCode']}")

Prêt à commencer ?

Explorez la référence API complète avec documentation interactive, exemples de requêtes et schémas de réponse.

Explorateur API interactifEssayer l'intégration MCP