---
title: "Get all coupons"
method: GET
path: "/ecommerce/coupons"
tags: ["🛒 Ecommerce"]
---

# Get all coupons

`GET /ecommerce/coupons`

## Request

- Base URL: `https://api.freeapi.app/api/v1`
- URL: `https://api.freeapi.app/api/v1/ecommerce/coupons`
- Auth: none declared
- TypeScript: <https://skmtc.dev/hiteshchoudhary-ssesph/apis/freeapi/docs/ecommerce/coupons/get.ts> (a function with typed inputs; its response is checked against the schema)

The API endpoint allows a logged-in user to retrieve all the available coupons in an ecommerce app before proceeding with the checkout process.

This API provides a list of coupons that users can apply to their purchase, potentially offering discounts or special offers.

## Query parameters

- `page` string
- `limit` string

## Response `200`

Get all coupons

- object
  - `data` object
    - `coupons` object[]
      - `__v` number
      - `_id` string
      - `couponCode` string
      - `createdAt` string
      - `discountValue` number
      - `expiryDate` string
      - `isActive` boolean
      - `minimumCartValue` number
      - `name` string
      - `owner` string
      - `startDate` string
      - `type` string
      - `updatedAt` string
    - `hasNextPage` boolean
    - `hasPrevPage` boolean
    - `limit` number
    - `nextPage` number
    - `page` number
    - `prevPage` unknown
    - `serialNumberStartFrom` number
    - `totalCoupons` number
    - `totalPages` number
  - `message` string
  - `statusCode` number
  - `success` boolean

---

[API](https://skmtc.dev/hiteshchoudhary-ssesph/apis/freeapi.md) - [All operations](https://skmtc.dev/hiteshchoudhary-ssesph/apis/freeapi/llms.txt) - [OpenAPI document](https://skmtc.dev/hiteshchoudhary-ssesph/apis/freeapi/revisions/a9f3a290e4dc?raw)