Invoices

List all invoices

GET/api/v1/invoices/admin

Lists invoices across every seller. Staff-only.

Requires Authorization

ADMIN, ACCOUNTANT only

Session

Query parameters

`page`number	Defaults to 1.
`limit`number	Max 100. Defaults to 20.
`sellerProfileId`string	Filter by seller.

Request

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

200Example response

{
  "success": true,
  "data": {
    "invoices": [
      {
        "id": "inv_1a2b3c",
        "sellerProfileId": "sp_2b3c4d",
        "number": "SWG-INV-2026-0042",
        "amount": "10.00",
        "currency": "USD",
        "issuedAt": "2026-02-01T09:05:00.000Z",
        "pdfUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/invoices/swg-inv-2026-0042.pdf"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
}