Paymavo

Dépenses

Suivez les dépenses professionnelles avec stockage des reçus et récurrence. Montants en cents.

Catégories : TELECOMMUNICATIONSSOFTWARE_TOOLSEQUIPMENTOFFICE_RENTTRAVELTRAININGBUSINESS_MEALSPROFESSIONAL_SERVICESOTHER

GETLister les dépenses

GEThttps://paymavo.com/api/v1/expenses

Paramètre	Type	Description
page	integer	Numéro de page (défaut : 1)
limit	integer	Éléments par page, max 100 (défaut : 20)
category	string	Filtrer par catégorie
dateAfter	date-time	Dépenses après cette date
dateBefore	date-time	Dépenses avant cette date
sort	string	date \| -date \| createdAt \| -createdAt (défaut : -date)

curl "https://paymavo.com/api/v1/expenses?category=SOFTWARE_TOOLS" \
  -H "Authorization: Bearer sk_live_xxx"

GETObtenir une dépense

GEThttps://paymavo.com/api/v1/expenses/{id}

curl https://paymavo.com/api/v1/expenses/clx789 \
  -H "Authorization: Bearer sk_live_xxx"

POSTCréer une dépense

POSThttps://paymavo.com/api/v1/expenses

Paramètre	Type	Description
supplier*	string	Fournisseur
amountHt*	integer	Montant HT en cents
taxAmount*	integer	Taxes en cents. totalWithTax = amountHt + taxAmount
category*	string	Catégorie de dépense
date*	date-time	Date de la dépense
description	string	Description
receiptUrl	uri	URL du fichier reçu
recurrent	boolean	Dépense récurrente
frequency	string	WEEKLY \| BIWEEKLY \| MONTHLY \| QUARTERLY \| YEARLY
recurringEndDate	date-time	Fin de la récurrence

curl -X POST https://paymavo.com/api/v1/expenses \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "supplier": "GitHub",
    "amountHt": 900,
    "taxAmount": 0,
    "category": "SOFTWARE_TOOLS",
    "date": "2026-03-01T00:00:00.000Z",
    "recurrent": true,
    "frequency": "MONTHLY"
  }'

PATCHModifier une dépense

PATCHhttps://paymavo.com/api/v1/expenses/{id}

curl -X PATCH https://paymavo.com/api/v1/expenses/clx789 \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "description": "Updated note" }'

DELETESupprimer une dépense

DELETEhttps://paymavo.com/api/v1/expenses/{id}

L'API supprime également le reçu associé du stockage s'il existe.

curl -X DELETE https://paymavo.com/api/v1/expenses/clx789 \
  -H "Authorization: Bearer sk_live_xxx"

GETObtenir l'URL du reçu

GEThttps://paymavo.com/api/v1/expenses/{id}/receipt

Renvoie l'URL Cloudinary du reçu. Renvoie une erreur 404 si aucun reçu n'est joint.

curl "https://paymavo.com/api/v1/expenses/clx789/receipt" \
  -H "Authorization: Bearer sk_live_xxx"