Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/MateoNavarroMN/Balsamoa-Backend/llms.txt

Use this file to discover all available pages before exploring further.

Sizes (talles) represent the physical size options available for Balsamoa products. Each product variant is defined by a combination of a size ID and a color ID. Retrieve the full list of sizes from this endpoint to populate a size picker or to build the variantes array when creating or updating a product.

​
Request

PropertyValue
MethodGET
Path/api/v1/admin/talles
No query parameters or request body are required.

​
Example

curl https://your-api.com/api/v1/admin/talles

​
Response

200 OK — An array of size objects, sorted by the orden field in ascending order. 
[
  { "id": 1, "nombre": "S",   "orden": 1 },
  { "id": 2, "nombre": "M",   "orden": 2 },
  { "id": 3, "nombre": "L",   "orden": 3 },
  { "id": 4, "nombre": "XL",  "orden": 4 },
  { "id": 5, "nombre": "XXL", "orden": 5 }
]

​
Response Fields

​
id
integer
The unique numeric identifier for this size. Pass this value as talle_id inside each object of the variantes array when creating or updating a product.
​
nombre
string
The human-readable size label (e.g., "S", "M", "XL").
​
orden
integer
A numeric sort key used to determine the display order of sizes in both the admin panel and the public store frontend. Lower values appear first.

​
Error Cases

StatusCauseResponse body
404The talles table contains no rows{"mensaje": "Registros no encontrados"}
The orden field is the canonical source of truth for size ordering across the entire application. The database view vista_catalogo_productos uses ORDER BY t.orden when aggregating stock_por_talle, so size objects on product responses always appear in the same sequence as returned by this endpoint.

Build docs developers (and LLMs) love

Get started for freeTalk to us