Saltar al contenido

Listar historial de precios

Devuelve los cambios de precio de un producto con la fecha de cada uno.

Parámetros de consulta

limit?integer

Cantidad máxima de resultados por devolver.

Formatoint32
cursor?string

Cursor de la respuesta anterior. Omítelo en la primera página.

search?string

Búsqueda de texto libre.

sortBy?string

Campo por el que se ordena.

sortDirection?string

Dirección del ordenamiento: asc o desc.

Valor en

  • "asc"
  • "desc"
productId?string

Identificador del producto.

variantId?string

Identificador de la variante.

reason?string

Solo registros con este motivo.

Valor en

  • "initial"
  • "manualUpdate"
  • "bulkEdit"
  • "promotionStart"
  • "promotionEnd"
  • "costAdjustment"
  • "import"
fromDate?string

Inicio del rango de fechas, inclusive.

Formatodate-time
toDate?string

Fin del rango de fechas, inclusive.

Formatodate-time

Parámetros de cabecera

x-Store-Id?string

Tienda sobre la que actúa la solicitud. No hace falta cuando el token ya está vinculado a una tienda.

Authorization*string

Token bearer OAuth 2.0.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.ecomiq.pe/api/v1/catalog/price-history" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "data": [    {      "id": "7204558912004328428",      "productId": "7204558912004322039",      "productName": "Mi tienda",      "variantName": "Mi tienda",      "sku": "POL-001-AZ-M",      "variantId": "7204558912004323197",      "newPrice": 89,      "reason": "Reposición de stock.",      "timestamp": "2026-09-28T15:30:00Z"    }  ],  "hasNextPage": true,  "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjUzMDEifQ",  "totalCount": 24}