List Offerings

curl --request GET \
  --url https://api-{dc}.moengage.com/v5/offers \
  --header 'Authorization: Basic <encoded-value>'

{
  "response_id": "resp_d31d6d61-6f3b-40dc-a459-548f385a60cb",
  "type": "offer",
  "data": [
    {
      "id": "offer_6a4f69ee490f66322f968b87",
      "name": "Summer_Sale_Promo_2026",
      "status": "active",
      "tags": [
        "tag_<object-id>"
      ],
      "created_at": "2026-06-23T12:29:41.225270281Z",
      "created_by": "marketing-team@example.com"
    },
    {
      "id": "offer_6a4f69ee490f66322f968b87",
      "name": "Homepage_Banner_AB_Test",
      "status": "scheduled",
      "created_at": "2026-06-23T12:29:41.225270281Z",
      "created_by": "growth-team@example.com"
    }
  ],
  "pagination": {
    "next_cursor": "b2ZmZXJzOjZhM2E3YzM0NTE4NjdkNGRjZmIxNzQ5Mw==",
    "limit": 20,
    "has_more": true,
    "total_count": 42
  }
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "One or more query parameters are invalid.",
    "doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
    "details": [
      {
        "code": "INVALID_ENUM_VALUE",
        "target": "status_in",
        "message": "'invalid_status' is not a valid status. Allowed values: active, scheduled, expired, archived, draft.",
        "doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview"
      }
    ]
  },
  "response_id": "resp_<trace-id>"
}

"{\"code\":\"ER001\",\"target\":\"Authentication Invalid\",\"message\":\"Auth validation failed.\"}"

"{\"code\":\"ER001\",\"target\":\"Authentication Invalid\",\"message\":\"Auth validation failed.\"}"

{
  "response_id": "<string>",
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
    "target": "<string>",
    "details": [
      {
        "code": "<string>",
        "target": "<string>",
        "message": "<string>"
      }
    ]
  }
}

"<html><body><h1>503 Service Temporarily Unavailable</h1></body></html>"

GET

offers

List Offerings

curl --request GET \
  --url https://api-{dc}.moengage.com/v5/offers \
  --header 'Authorization: Basic <encoded-value>'

{
  "response_id": "resp_d31d6d61-6f3b-40dc-a459-548f385a60cb",
  "type": "offer",
  "data": [
    {
      "id": "offer_6a4f69ee490f66322f968b87",
      "name": "Summer_Sale_Promo_2026",
      "status": "active",
      "tags": [
        "tag_<object-id>"
      ],
      "created_at": "2026-06-23T12:29:41.225270281Z",
      "created_by": "marketing-team@example.com"
    },
    {
      "id": "offer_6a4f69ee490f66322f968b87",
      "name": "Homepage_Banner_AB_Test",
      "status": "scheduled",
      "created_at": "2026-06-23T12:29:41.225270281Z",
      "created_by": "growth-team@example.com"
    }
  ],
  "pagination": {
    "next_cursor": "b2ZmZXJzOjZhM2E3YzM0NTE4NjdkNGRjZmIxNzQ5Mw==",
    "limit": 20,
    "has_more": true,
    "total_count": 42
  }
}

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "One or more query parameters are invalid.",
    "doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
    "details": [
      {
        "code": "INVALID_ENUM_VALUE",
        "target": "status_in",
        "message": "'invalid_status' is not a valid status. Allowed values: active, scheduled, expired, archived, draft.",
        "doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview"
      }
    ]
  },
  "response_id": "resp_<trace-id>"
}

"{\"code\":\"ER001\",\"target\":\"Authentication Invalid\",\"message\":\"Auth validation failed.\"}"

"{\"code\":\"ER001\",\"target\":\"Authentication Invalid\",\"message\":\"Auth validation failed.\"}"

{
  "response_id": "<string>",
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "doc_url": "https://www.moengage.com/docs/api/offerings/offerings-overview",
    "target": "<string>",
    "details": [
      {
        "code": "<string>",
        "target": "<string>",
        "message": "<string>"
      }
    ]
  }
}

"<html><body><h1>503 Service Temporarily Unavailable</h1></body></html>"

Rate Limit

The rate limit is 150 requests per minute, 500 requests per hour, and 1000 requests per day per consumer.

Authorizations

Authorization

string

header

required

Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.

Username: Use your MoEngage Workspace ID (also known as the App ID). Find it in the dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
Password: On your MoEngage workspace, navigate to Settings > Account > API keys. Use the Key listed within the Personalize tile.

For more information on authentication and getting your credentials, refer to Getting your credentials. Send the value in the Authorization header as Basic followed by Base64-encoding of appkey:apisecret (workspace ID and API key).

Headers

X-MOE-Request-Id

string<uuid>

Client-supplied trace ID (UUID v4). Echoed back in the X-MOE-Request-Id response header.

Query Parameters

string

Look up a single offering by its exact prefixed ID (e.g. offer_6a4f69ee490f66322f968b87). Use this when you already know the offering ID and want to confirm it exists before updating it.

name_contains

string

Find offerings whose name contains specific text (case-insensitive). For example, pass "summer" to find all summer-related offerings.

Maximum string length: 100

status_in

string

Filter by lifecycle status. Valid values: active, scheduled, expired, archived, draft. Example: status_in=active,scheduled

Response

Paginated list of offerings.

response_id

string

required

Format: resp_<X-MOE-Request-Id> header value (auto-generated UUID if the X-MOE-Request-Id header was not part of the request body).

type

enum<string>

required

Available options:

offer

data

object[]

required

List of offering summaries matching the applied filters.

Show child attributes

pagination

object

required

Pagination metadata included in list responses.

Show child attributes

Offerings Overview Create Offering

⌘I

​Rate Limit

Authorizations

Headers

Query Parameters

Response

Rate Limit