Details of a Promotion

You can retrieve detailed information about a specific Promotion through the Aptoide Connect Developer Console or programmatically via this API endpoint.

Endpoint

Method	URL
GET	https://ws.catappult.io/api/promotions/{uid}

Authentication

To access this API, you need to have an active account subscription on Aptoide Connect and authenticate with an API key (check here how to generate one).

Headers

Header	Type	Required	Description
Api-Key	string	Required	Used to authenticate your API requests. The value is your Aptoide Connect API key.

Path Parameters

Parameter	Type	Description
uid	string	The unique identifier (UUID) of the promotion (e.g. 9dbf70ff-30a4-4d82-b062-42ab24126e59).

Example Request

curl -X GET "https://ws.catappult.io/api/promotions/9dbf70ff-30a4-4d82-b062-42ab24126e59" \
  -H "Api-Key: <YOUR_API_KEY>"

Response

Success

If the API call returns an HTTP 200 status code, the request was successful and it returns a JSON object containing detailed information about the promotion.

When a promotion is linked to an Event (via eventUid), the event field contains an embedded representation of that event; otherwise it is null.

Example Response

{
  "uid": "9dbf70ff-30a4-4d82-b062-42ab24126e59",
  "name": "Test Promotion 1",
  "type": "SEARCH",
  "status": "active",
  "startTimestamp": "2026-03-16 00:00:00",
  "endTimestamp": "2026-04-30 00:00:00",
  "createdAt": "2026-03-26 20:47:20",
  "updatedAt": "2026-04-01 14:23:34",
  "hasStatistics": false,
  "event": {
    "uid": "56fd535b-b071-402c-a4fa-29807eb050c9",
    "name": "Test Event",
    "type": "CUSTOM",
    "status": "active",
    "startTimestamp": "2026-02-04 00:30:00",
    "endTimestamp": "2026-04-30 00:00:00",
    "createdAt": "2026-02-05 16:06:33",
    "updatedAt": "2026-04-20 15:01:53",
    "allowedPartners": ["APTOIDE-GAMES"],
    "application": {
      "name": "com.aptoide.diceroll.sdk",
      "title": "Aptoide Diceroll SDK",
      "iconUrl": "https://ws.catappult.io/api/applications/com.aptoide.diceroll.sdk/icon",
      "featureGraphicUrl": "https://ws.catappult.io/api/applications/com.aptoide.diceroll.sdk/featureGraphic"
    },
    "data": {
      "allowedPartners": "APTOIDE-GAMES",
      "applySameFilesToAllLocales": "false"
    },
    "locales": [
      {
        "localeName": "en_GB",
        "description": "Test",
        "longDescription": "Test",
        "files": [
          {
            "id": 953,
            "name": "b737866e7065a09e02a8393dd4c83a42_com-aptoide-diceroll-sdk-none-promotion-asset.webp",
            "downloadUrl": "https://cdn-catappult.aptoide.com/promotion_asset/b737866e7065a09e02a8393dd4c83a42_com-aptoide-diceroll-sdk-none-promotion-asset.webp",
            "ratio": "256:125"
          }
        ]
      }
    ]
  },
  "partner": { "name": "APTOIDE-GAMES" },
  "application": {
    "name": "com.aptoide.diceroll.sdk",
    "title": "Aptoide Diceroll SDK",
    "operatingSystem": "android",
    "iconUrl": "https://ws.catappult.io/api/applications/com.aptoide.diceroll.sdk/icon",
    "featureGraphicUrl": "https://ws.catappult.io/api/applications/com.aptoide.diceroll.sdk/featureGraphic"
  },
  "data": {
    "name": "Test Promotion 1",
    "oemId": "562c8031d4a08ba95e682a800cd04448",
    "utmContent": "search"
  },
  "files": [
    {
      "id": 385,
      "name": "64c5826a724c1bb78332c0ed67b5f83b_com-aptoide-diceroll-sdk-none-promotion-asset.png",
      "downloadUrl": "https://cdn-catappult.aptoide.com/promotion_asset/64c5826a724c1bb78332c0ed67b5f83b_com-aptoide-diceroll-sdk-none-promotion-asset.png"
    }
  ]
}