List marketplace panels (sections)

Staging

https://fin-api.digetpay.com

GET

/v1/developer-portal/applications/{id}/listing/panels

Returns every backend-driven section of the listing detail page, ordered by sortOrder, each with its cards in display order. A listing always has at least the implicit ALL_CARDS panel once the first card is authored.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://fin-api.digetpay.com/v1/developer-portal/applications//listing/panels' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

Panels of the listing, each with its cards.

Bodyapplication/json

Example

[
    {
        "id": "12",
        "sortOrder": 0,
        "layout": "HERO_CAROUSEL",
        "panelType": "OCCASIONS",
        "titleEn": "Gift cards",
        "titleAr": "بطاقات الهدايا",
        "showTitle": false,
        "featuredStoreId": "101",
        "featuredStoreLabelEn": "Acme Store",
        "featuredStoreLabelAr": "متجر أكمة",
        "subtitleEn": "Iftar & suhoor deals, all month",
        "subtitleAr": "عروض الإفطار والسحور طوال الشهر",
        "themeColor": "#16A34A",
        "bodyEn": "Buy a gift card and it lands instantly in your account.",
        "bodyAr": "اشترِ بطاقة هدايا وستصلك فوراً إلى حسابك.",
        "expiresAt": "2026-09-18T21:00:00.000Z",
        "bannerImageUrl": "https://storage/dgp/panel-banner.png",
        "offers": [
            {
                "id": "42",
                "panelId": "12",
                "sortOrder": 0,
                "titleEn": "Silver top-up",
                "titleAr": "تعبئة فضية",
                "descriptionEn": "string",
                "descriptionAr": "string",
                "imageUrl": "https://storage.googleapis.com/...?Signature=...",
                "design": "banner",
                "linkType": "deeplink",
                "url": "https://partner.acme.sa/buy/silver",
                "price": "49.99",
                "originalPrice": "79.99",
                "currency": "SAR",
                "inStock": true,
                "available": true,
                "perUserLimit": 5,
                "badgeLabel": "Best seller",
                "badgeColor": "#E8553C",
                "bannerImageUrl": "https://storage.googleapis.com/...?Signature=...",
                "highlightText": "Limited-time offer",
                "termsEn": "Digital card delivered instantly. Non-refundable.",
                "termsAr": "البطاقة الرقمية تُسلَّم فوراً وغير قابلة للاسترداد.",
                "offerExpiresAt": "2026-12-31T23:59:59.000Z",
                "fulfillmentMode": "INSTANT"
            }
        ]
    }
]

🟠401Unauthorized

🟠404Record Not Found

Modified at 2026-09-16 09:43:02

Upload a panel (section) banner image

Create a marketplace panel (section)