Skip to main content
GET
/
ecommerce
/
coupons
List ecommerce coupons
curl --request GET \
  --url https://api.service.getjusto.com/v3/ecommerce/coupons \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "items": [
      {
        "_id": "<string>",
        "websiteId": "<string>",
        "code": "<string>",
        "name": "<string>",
        "description": "<string>",
        "active": true,
        "percentageOff": 123,
        "maxPercentageOffDiscount": 123,
        "discountAmount": 123,
        "fixedAmount": 123,
        "fromDate": "2020-01-01T00:00:00.000Z",
        "endDate": "2020-01-01T00:00:00.000Z",
        "maxRedemptions": 123,
        "maxRedemptionsPerUser": 123,
        "maxRedemptionsPerUserPerDay": true,
        "maxRedemptionsPerCode": 123,
        "totalRedemptions": 123,
        "onlyForNewUsers": true,
        "onlyForProductsWithoutDiscount": true,
        "requirePhoneVerification": true,
        "requiresCategoriesIds": [
          "<string>"
        ],
        "requiresProductsIds": [
          "<string>"
        ],
        "requiresStoresIds": [
          "<string>"
        ],
        "requiresMenusIds": [
          "<string>"
        ],
        "requiresPaymentTypes": [
          "<string>"
        ],
        "requireChannels": [
          "<string>"
        ],
        "requiredBINs": [
          "<string>"
        ],
        "minimumOrderPrice": 123,
        "maximumOrderPrice": 123,
        "dontApplyToProductsIds": [
          "<string>"
        ],
        "dontApplyDiscountToOptions": true,
        "isHidden": true,
        "allowedEmails": [
          "<string>"
        ],
        "externalId": "<string>",
        "isBirthdayCoupon": true,
        "onlyRedeemOnBirthday": true,
        "autoRecommend": true,
        "applyDeliveryDiscount": true,
        "deliveryDiscountValue": 123,
        "deliveryDiscountType": "<string>",
        "deliveryDiscountPercentage": 123,
        "maxProductsPerOrder": 123,
        "createdAt": "2020-01-01T00:00:00.000Z",
        "deletedAt": "2020-01-01T00:00:00.000Z"
      }
    ],
    "hasNextPage": true,
    "hasPreviousPage": true,
    "totalPages": 123,
    "totalCount": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.getjusto.com/llms.txt

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

Lista los cupones ecommerce de la marca autorizada. Usa este endpoint para auditar campañas, revisar cupones activos o buscar cupones por texto sin exponer ni aceptar websiteId en la request. La respuesta viene paginada. Para descargas completas desde Justo Admin MCP, usa generate_data_file; para una vista rápida usa get_data, que devuelve sólo una muestra.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

filter
string

Texto para buscar por nombre, código o externalId.

storesIds
string[]

Locales usados para filtrar cupones aplicables a esos locales.

page
number

Número de página.

Example:

1

limit
number

Número de items por página. Max 100. Por defecto: 10.

Example:

10

Response

The OpenAPI spec

success
boolean
Example:

true

data
object