---
title: "Consultar todas las promociones"
method: GET
path: "/promos"
tags: ["Promociones"]
---

# Consultar todas las promociones

`GET /promos`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/promos`
- Auth: HTTP bearer

Retorna todas las promociones activas (no eliminadas) del negocio del usuario autenticado,
ordenadas por nombre. Si el negocio hereda productos del padre y tiene `inheritParentsProducts`
habilitado, también incluye las promociones del negocio padre.

**Autenticación requerida:** Bearer Token obtenido del campo `tokenCurrent` en el servicio de login.

`Authorization: Bearer {tokenCurrent}`

## Response `200`

Lista de promociones obtenida exitosamente

- Promo[]
  - `_id` string: ID único de la promoción
  - `business` string: ID del negocio al que pertenece la promoción
  - `name` string, required: Nombre de la promoción
  - `description` string: Descripción de la promoción
  - `type` 'Porcentaje' | 'ProcentajeCantidad' | 'Cantidad', required: Tipo de promoción: Porcentaje | ProcentajeCantidad | Cantidad
  - `dateSettings` object: Configuración de fechas y horarios de la promoción
    - `date` object
      - `start` string, date-time
      - `final` string, date-time
    - `days` string[]: Días activos: L=Lunes, M=Martes, X=Miércoles, J=Jueves, V=Viernes, S=Sábado, D=Domingo
    - `happyHours` object
      - `isHappyHour` boolean
      - `hours` object
        - `hourStart` object
          - `hour` number
          - `minute` number
        - `hourEnd` object
          - `hour` number
          - `minute` number
  - `data` object: Datos de la promoción según su tipo
    - `typePorcentaje` object: Datos para tipo Porcentaje
      - `value` number
    - `typePorcentajeCantidad` object: Datos para tipo ProcentajeCantidad
      - `values` object[]
        - `qtyMin` number
        - `qtyMax` number
        - `value` number
    - `typeCantidad` object: Datos para tipo Cantidad (ej: lleva 3 paga 2)
      - `takeAmount` number
      - `payAmount` number
  - `isActive` boolean: Indica si la promoción está activa
  - `forDigitalMenu` boolean: Indica si aplica para el menú digital
  - `deleted` boolean: Indica si la promoción fue eliminada (soft delete)
  - `createdOn` string, date-time: Fecha de creación
  - `modifiedOn` string, date-time: Fecha de última modificación

## Other responses

- `401`: No autorizado - Token JWT inválido o ausente
- `500`: Error del servidor al consultar las promociones

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)