List authored marketplace offers (cards)

Staging

https://fin-api.digetpay.com

GET

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

Returns every card the developer authored for the listing, ordered by sortOrder. gs:// image paths are returned as short-lived signed read URLs. Requires a saved listing (else 404).

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/offers' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

Authored offers for the listing.

Bodyapplication/json

Example

[
    {
        "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

Unpublish a live or scheduled marketplace listing

Create a marketplace offer (card)