1. Vendors - User
3enab
👤 User Application
  • 👤 User Application
  • 🏪 Vendor Application
  • 👨‍💼 Admin Application
  • 🚚 Delivery Application
  • Auth - User
    • Register a new user
      POST
    • Login user
      POST
    • Logout user
      POST
    • Refresh access token
      POST
    • Send phone OTP
      POST
    • Verify phone OTP
      POST
    • Send password reset OTP
      POST
    • Verify password reset OTP
      POST
    • Reset password
      POST
  • Addresses - User
    • Create a new address
      POST
    • Get all addresses
      GET
    • Get default address
      GET
    • Get address by ID
      GET
    • Update address
      PUT
    • Delete address
      DELETE
    • Set as default address
      PATCH
  • Ads - User
    • Get all advertisements
      GET
    • Get a specific advertisement by ID
      GET
  • Coupons - User
    • Get available coupons
      GET
  • Delivery Areas - User
    • Get all active delivery areas
      GET
  • Items - User
    • Get all items
      GET
    • Get a specific item by ID
      GET
    • Get variants of an item
      GET
    • Get all items (Direct Access)
      GET
    • Get all items for a specific vendor (Direct Access)
      GET
    • Get item by ID (Direct Access)
      GET
  • Menu Categories - User
    • Get all active menu categories for a vendor
    • Get a menu category by ID
  • Orders - User
    • Preview order pricing
    • Get all orders
    • Create a new order
    • Get order by ID
    • Cancel order
  • Rates - User
    • Create a new rating for a vendor
    • Get all ratings for a vendor
    • Get a specific rating by ID
    • Update a rating
    • Delete a rating
  • Users - User
    • Get current user profile
    • Update current user profile
    • Delete current user account
    • Change user password
  • Vendor Categories - User
    • Get all active vendor categories
    • Get a vendor category by ID
  • Vendors - User
    • Get all active vendors
      GET
    • Get vendor by ID
      GET
    • Get vendor logo
      GET
  • Versions - User
    • Get the latest version for User app
  • App Notices - User
    • Get active app notices
  1. Vendors - User

Get all active vendors

GET
/api/v1/vendors
Public endpoint to retrieve all active vendors with pagination

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Query Params

Responses

🟢200OK
application/json
Vendors retrieved successfully
Body

Example
{
    "status": "success",
    "message": "Vendors fetched successfully",
    "data": {
        "vendors": {
            "vendors": [
                {
                    "_id": "507f1f77bcf86cd799439011",
                    "name": "Pizza Palace",
                    "description": "Best pizza in town",
                    "category": "507f1f77bcf86cd799439013",
                    "workingHours": {
                        "open": "09:00",
                        "close": "21:00",
                        "days": [
                            "Monday",
                            "Tuesday",
                            "Wednesday",
                            "Thursday",
                            "Friday",
                            "Saturday",
                            "Sunday"
                        ]
                    },
                    "logoPath": "/uploads/vendorsLogos/507f1f77bcf86cd799439011.jpg",
                    "coverPath": "/uploads/vendorsCovers/507f1f77bcf86cd799439011.jpg",
                    "averageRate": 4.5,
                    "totalRates": 150,
                    "order": 0,
                    "freeDelivery": false,
                    "notice": {
                        "title": "We are currently busy",
                        "details": "Orders may take longer than usual",
                        "imagePath": "/uploads/vendorsNotices/507f1f77bcf86cd799439011.jpg",
                        "isActive": true
                    },
                    "preparationTime": {
                        "from": 30,
                        "to": 45,
                        "unit": "minute"
                    },
                    "createdAt": "2019-08-24T14:15:22.123Z",
                    "updatedAt": "2019-08-24T14:15:22.123Z"
                }
            ],
            "total": 50,
            "page": 1,
            "limit": 10,
            "totalPages": 5
        }
    }
}
🔴500Internal Server Error
Modified at 2026-04-08 13:48:58
Previous
Get a vendor category by ID
Next
Get vendor by ID
Built with