Skip to content

Category Promotion APIs


1. List Category Promotions

Endpoint

  • URL: /api/v1/catalog/category/promotion/list/
  • Method: GET
  • Permission Required: AllowAny

Description

Retrieve all active category promotions. The response includes details about each promotion, such as the promotion's name, description, and associated category.

Response Examples

Success

[
    {
        "id": 2,
        "title": "Sarees that Speak of Grace, Culture, and Beauty",
        "description": "Draped in silk and tradition, each fold tells stories woven through generations\r\nWhere artisanal craftsmanship meets timeless elegance, creating poetry in six yards of fabric",
        "banner_image": "https://api.kurtasari.com/media/category/promotion/banner_image/80a9e7fe01c5c3banner_39c7c2355c3ce25c499.png",
        "thumbnail_image": null,
        "start_date": null,
        "end_date": null,
        "cta_url": null,
        "is_active": true
    },
    {
        "id": 1,
        "title": "Celebrate Tradition with Contemporary Charm",
        "description": "Bridging centuries with every thread, where ancestral techniques dance with modern design\r\nEach piece tells a story of heritage reimagined for today's world\r\nFrom classic motifs transformed by bold new palettes to traditional weaves with contemporary twists\r\nWe honor our roots while embracing the future, creating pieces that resonate across generations\r\nWhere timeless craft meets progressive style, making tradition relevant for the modern woman",
        "banner_image": "https://api.kurtasari.com/media/category/promotion/banner_image/banner_image_YSOyAao_ySmeYxA.png",
        "thumbnail_image": null,
        "start_date": "11-13-2024 07:02:38",
        "end_date": "01-01-2025 07:02:45",
        "cta_url": "https://kurtasari.com/kurtas/Cotton%20Kurti/3",
        "is_active": true
    },
]


1. Get Category Promotion by ID

Endpoint

  • URL: /api/v1/catalog/category/promotion/list/{id}/
  • Method: GET
  • Permission Required: AllowAny

Description

Retrieve a specific category promotion using its ID.

Path Parameter

  • id (Required): The ID of the category promotion.

Request Payload

This API does not require request payload.

Response Examples

Success

 {
        "id": 2,
        "title": "Sarees that Speak of Grace, Culture, and Beauty",
        "description": "Draped in silk and tradition, each fold tells stories woven through generations\r\nWhere artisanal craftsmanship meets timeless elegance, creating poetry in six yards of fabric",
        "banner_image": "https://api.kurtasari.com/media/category/promotion/banner_image/80a9e7fe01c5c3banner_39c7c2355c3ce25c499.png",
        "thumbnail_image": null,
        "start_date": null,
        "end_date": null,
        "cta_url": null,
        "is_active": true
}