Expenses

List expenses

GET/api/v1/expenses

Lists expenses.

Requires Authorization

ADMIN, ACCOUNTANT only

Session

Query parameters

`page`number	Defaults to 1.
`limit`number	Max 50. Defaults to 20.
`status`string	PENDING, REJECTED, PROCESSING, COMPLETED, or FAILED.
`category`string

Request

curl --request GET \
  --url https://api.swiftgoma.com/api/v1/expenses \
  --header 'Authorization: Bearer <access_token>'

200Example response

{
  "success": true,
  "data": {
    "expenses": [
      {
        "id": "exp_1a2b3c",
        "reference": "SWG-EXP-2026-0014",
        "title": "Renouvellement hébergement serveur",
        "description": "Facture mensuelle du fournisseur d'hébergement.",
        "category": "UTILITIES",
        "amount": "150.00",
        "currency": "USD",
        "status": "PENDING",
        "incurredAt": "2026-02-10T00:00:00.000Z",
        "vendorName": "CloudHost SARL",
        "vendorPhone": "243812345678",
        "countryCode": "CD",
        "providerName": "MTN_MOMO_COD",
        "createdBy": {
          "id": "9f8e7d6c",
          "name": "Marie Kanku"
        },
        "approvedBy": null,
        "createdAt": "2026-02-10T08:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
}