Admin

List users

GET/api/v1/users

Lists platform users with pagination and optional filters. Staff-only.

Requires Authorization

ADMIN, SUPPORT only

Session

Query parameters

`page`number	Page number. Defaults to 1.
`limit`number	Results per page, max 100. Defaults to 20.
`search`string	Matches against name and email.
`role`string	Filter by BUYER, SELLER, RIDER, SUPPORT, or ADMIN.

Request

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

200Example response

{
  "success": true,
  "data": {
    "users": [
      {
        "id": "3f2a1c9e-7b41-4e2a-9c31-8e6b2d4f10aa",
        "name": "Aline Mapendo",
        "role": "BUYER",
        "email": "aline@example.com",
        "isEmailVerified": true,
        "phone": "243812345678",
        "isPhoneVerified": true,
        "preferredCurrency": "USD",
        "avatarUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/avatars/aline.jpg",
        "isBlocked": false,
        "createdAt": "2026-01-14T10:32:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "totalPages": 1
    }
  }
}