POST /api/product/list-product — Paginated product catalog

The list endpoint returns a paginated slice of the full product catalog, sorted newest-first. It is accessible without authentication, making it suitable for public-facing storefronts. When called with a valid token the request is processed identically — the TokenOptional middleware simply attaches user context when a token is present, without blocking unauthenticated requests. Pagination is controlled via path parameters. If pag and perpage are omitted, the server defaults to page 1 with 10 items per page.

POST /api/product/list-product/:pag?/:perpage?

Auth: Optional (token accepted but not required)

Path parameters

pag

number

Page number to retrieve. Defaults to 1 when omitted. Pages are 1-indexed — passing 1 returns the first page.

perpage

number

Number of products per page. Defaults to 10 when omitted.

Responses

msj

string

"Cargando productos..." on success.

status

boolean

true on success.

data

array

Array of product objects for the requested page, sorted by _id descending (newest first).

Show Product object fields

_id

string

MongoDB ObjectId uniquely identifying the product.

userId

string

ID of the user who created the product.

title

string

Display name of the product.

description

string

Full product description.

price

number

Base price before any discount.

minCant

number

Minimum stock quantity. Defaults to 0.

discount

string

Discount status. Either the raw percentage string (e.g. "20") set during an update, or "Sin descuento" if no discount has been applied.

priceDiscount

string

Calculated discounted price as a string (e.g. "23.992"), or an empty string if no discount is active.

colorsSize

array

Available color options.

Show colorsSize item fields

label

string

Human-readable color name (e.g. "Rojo").

value

string

Numeric string ID for the color (e.g. "14").

sizes

array

Available garment sizes.

Show sizes item fields

label

string

Size label (e.g. "M").

value

string

Numeric string ID for the size (e.g. "3").

typeShirt

string

Fit/style category. One of:

Value	Description
`Overside`	Oversized fit
`CropTop`	Crop top cut
`Regular Fit`	Standard regular fit
`Semi-Overside`	Semi-oversized fit
`Hoodie`	Hooded sweatshirt

productImg

array

Array of image file paths stored on the server (e.g. ["storage/product/12image1.jpg"]).

points

object

Like/reaction counters for the product.

Show points fields

cant

number

Total number of likes the product has received.

users

array

Array of user IDs who have liked this product.

createdAt

string

ISO 8601 timestamp of when the product was created.

updatedAt

string

ISO 8601 timestamp of the most recent update.

pagination

object

Pagination metadata for the current response.

Show pagination fields

pag

string

The current page number as supplied in the path (or undefined if omitted).

perpage

number

The number of items per page used for this request.

pags

number

Total number of pages available, calculated as ⌈totalProducts / perpage⌉.

Error responses

Status	Cause
`500`	Unexpected server error.

Example

# Fetch the first page with 10 products (default)
curl -X POST https://your-domain.com/api/product/list-product

# Fetch page 2 with 5 products per page
curl -X POST https://your-domain.com/api/product/list-product/2/5

# Authenticated request (token optional — same response shape)
curl -X POST https://your-domain.com/api/product/list-product/1/20 \
  -H "Authorization: Bearer <token>"

Success response (200):

{
  "msj": "Cargando productos...",
  "status": true,
  "data": [
    {
      "_id": "664a1f2e8b3c4d001e2f3a4b",
      "userId": "663f0e1d7a2b3c000d1e2f3a",
      "title": "Classic Logo Tee",
      "description": "Comfortable everyday crew-neck t-shirt.",
      "price": 29.99,
      "minCant": 50,
      "discount": "Sin descuento",
      "priceDiscount": "",
      "colorsSize": [
        { "label": "Blanco", "value": "1" },
        { "label": "Negro", "value": "2" }
      ],
      "sizes": [
        { "label": "S", "value": "2" },
        { "label": "M", "value": "3" },
        { "label": "L", "value": "4" }
      ],
      "typeShirt": "Regular Fit",
      "productImg": ["storage/product/12image1.jpg"],
      "points": {
        "cant": 5,
        "users": ["663f0e1d7a2b3c000d1e2f3b"]
      },
      "createdAt": "2024-05-20T14:32:00.000Z",
      "updatedAt": "2024-05-20T14:32:00.000Z"
    }
  ],
  "pagination": {
    "pag": "2",
    "perpage": 5,
    "pags": 8
  }
}

Users

Products

Sales

Notifications

POST /api/product/list-product — Paginated product catalog

POST /api/product/list-product/:pag?/:perpage?

Path parameters

Responses

Error responses

Example

Build docs developers (and LLMs) love

Users

Products

Sales

Notifications

Documentation Index

​POST /api/product/list-product/:pag?/:perpage?

​Path parameters

​Responses

​Error responses

​Example

Build docs developers (and LLMs) love

POST /api/product/list-product/:pag?/:perpage?

Path parameters

Responses

Error responses

Example