Orgivafood API

Create a customer account with email + password.

{ "name": "Ayesha Malik", "email": "ayesha@example.com", "phone": "+92 300 1234567", "password": "secret123" }

Log in with email + password. Returns { user, token }.

{ "email": "ayesha@example.com", "password": "secret123" }

Dedicated login for the admin panel — only succeeds for accounts with role: "admin".

{ "email": "admin@orgivafood.pk", "password": "Admin@123" }

Request a 4-digit OTP for a phone number, valid for OTP_EXPIRES_MINUTES. Demo backend — no SMS gateway is wired up, so the response includes devOtp for testing.

{ "phone": "+92 300 1234567" }

Verify the OTP and log in, auto-creating a bare customer account on first login. Returns { user, token }.

{ "phone": "+92 300 1234567", "code": "4821" }

Return the currently authenticated user's profile.

List customers.

Get one customer plus their order history.

Update a customer's name, phone, status, or address.

{ "status": "Blocked" }

Delete a customer account.

List products with filtering, search, sorting and pagination.

Get one product by its Mongo id or its slug (e.g. turmeric-powder).

Create a product. slug is auto-generated from name if omitted.

{
  "name": "Turmeric Powder", "sku": "ORG-TUR-200", "category": "Spices",
  "price": 149, "mrp": 199, "unit": "200g", "stock": 84,
  "image": "https://images.unsplash.com/photo-...", "tags": ["Best Sellers", "Spices"]
}

Update any product fields.

Quick status toggle: Active, Draft, Out of Stock, Low Stock.

{ "status": "Out of Stock" }

Delete a product.

List categories (optionally ?status=Active). Each includes productCount.

Get one category by id or slug.

Create a category.

{ "name": "Organic Oil", "image": "https://...", "description": "Cold-pressed cooking oils." }

Update a category.

Delete a category.

Guests see only Published reviews. An authenticated admin can filter by any status.

Submit a review — works for guests (pass name) or logged-in customers. Always starts as Pending.

{ "product": "<productId>", "rating": 5, "title": "Great quality", "text": "Loved it!", "name": "Ayesha" }

Moderate a review — approving or rejecting it also recalculates the product's average rating.

{ "status": "Published" }

Delete a review.

Get (or lazily create) the current cart.

Add a product, or increase its quantity (capped at 10).

{ "productId": "<productId>", "quantity": 2 }

Set an item's exact quantity.

{ "quantity": 3 }

Remove one item from the cart.

Clear the cart.

Place an order (checkout). Works for guests or logged-in customers; applies a coupon if given, decrements product stock, and computes shipping (free ≥ Rs 499, otherwise Rs 49).

{
  "contactInfo": { "firstName": "Ahmed", "lastName": "Khan", "email": "ahmed@example.com", "phone": "+92 300 1234567" },
  "shippingAddress": { "street": "House 12, Street 4", "city": "Lahore", "province": "Punjab", "postalCode": "54000" },
  "items": [{ "product": "<productId>", "name": "Turmeric Powder", "price": 149, "quantity": 2 }],
  "paymentMethod": "COD",
  "couponCode": "FLAT50"
}

Admins see every order; customers see only their own.

Get one order (customers can only fetch their own).

Update order and/or payment status.

{ "orderStatus": "Shipped", "paymentStatus": "Paid" }

Delete an order.

Validate a coupon at checkout before it's applied — checks status, expiry, usage limit and minimum order.

List all coupons.

Create a coupon.

{ "code": "FLAT50", "type": "Fixed", "value": 50, "minOrder": 499, "usageLimit": 2000, "expiryDate": "2026-12-31" }

Update a coupon.

Delete a coupon.

List banners — only Active ones by default.

Create a banner.

{ "title": "Everything You Love in One Place", "placement": "Hero Slider", "image": "https://...", "linkTo": "/collections/all" }

Update a banner.

Delete a banner.

List posts — only Published by default.

Get one post by slug — increments its view counter.

Create a post. slug auto-generates from title if omitted.

{ "title": "5 Reasons to Switch to Cold-Pressed Oils", "excerpt": "...", "image": "https://...", "body": ["Paragraph one.", "Paragraph two."], "status": "Published" }

Update a post.

Delete a post.

List testimonials (?all=true for admin to include hidden ones).

Create a testimonial.

{ "name": "Ayesha Malik", "location": "Karachi", "rating": 5, "text": "..." }

Update a testimonial.

Delete a testimonial.

List FAQs, ordered by order. Optional ?category= filter.

Create an FAQ.

{ "question": "Do you deliver across Pakistan?", "answer": "Yes, nationwide in 3–7 business days.", "category": "Shipping" }

Update an FAQ.

Delete an FAQ.

Subscribe an email (re-subscribes if it already exists).

{ "email": "ahmed@example.com", "source": "Footer Newsletter" }

List subscribers (?status=, page, limit).

Update a subscriber's status.

Delete a subscriber.

Submit a contact message.

{ "name": "Ahmed Khan", "email": "ahmed@example.com", "phone": "+92 300 1234567", "subject": "Bulk order", "message": "..." }

List messages (?status=, page, limit).

Mark a message Read or Responded.

Delete a message.

Get site settings (auto-created with sensible defaults on first request).

Update site settings.

{ "freeShippingThreshold": 599, "standardShippingFee": 60 }

Headline totals: revenue (from paid orders), order count, customer count, product count.

Revenue grouped by day for the last 7 days.

Order counts grouped by orderStatus, for a pie/bar chart.