Returns the full participation history for a specific promotion for a member, including enrollment and opt-in timeline details, promotion metadata, and promotion-level custom fields.

Example request

curl -X GET "https://{host}/v3/members/388757266/promotions/1133608813?memberEnrollmentStatus=AVAILABLE_TO_REDEEM" \
  -H "Authorization: Basic dGlsbGhnXXXXXXXX"

Prerequisites

Authentication: Basic authentication. Provide a valid Authorization header.
The member must exist in the org.
The promotion must be in ACTIVE, PAUSED, or STOPPED status.

Resource information


Pagination	No
Batch support	No

Path parameters

Field	Type	Required	Description
`memberId`	Long	Yes	Unique identifier of the member.
`promotionId`	Long	Yes	Unique identifier of the promotion. Must resolve to an `ACTIVE`, `PAUSED`, or `STOPPED` promotion.

Query parameters

Field	Type	Required	Description
`memberEnrollmentStatus`	String	Optional	Filters the returned participation timeline by enrollment status. Supported values: `PENDING_ENROLLMENT`, `PENDING_OPT_IN`, `AVAILABLE_TO_REDEEM`, `REDEEMED`, `EXPIRED`. Case-sensitive.
`promotionIdentifier`	String	Optional	Filters results to a specific promotion by its unique string identifier. Must resolve to an `ACTIVE`, `PAUSED`, or `STOPPED` promotion, otherwise error `310193` is returned.

API Quick Reference

GET /v3/members/{memberId}/promotions/{promotionId}
└─ response
    ├─ memberId (number)
    └─ promotions []
        ├─ promotionId (number)
        ├─ promotionName (string)
        ├─ programId (number)
        ├─ startDateISO (string)
        ├─ endDateISO (string)
        ├─ timezoneName (string)
        ├─ promotionIdentifier (string)
        ├─ unifiedPromotionId (string)
        ├─ description (string)
        ├─ active (boolean)
        ├─ optInStartDateISO (string)
        ├─ optInEndDateISO (string)
        ├─ promotionCustomFields []
        │   ├─ key (string)
        │   ├─ value (string)
        │   └─ brandDefined (boolean)
        └─ customerPromotionTimelines []
            └─ enrollmentDetails []
                ├─ enrollmentId (number)
                ├─ enrollmentDateISO (string)
                ├─ enrollmentExpiryDateISO (string)
                ├─ enrollEventLogId (number)
                ├─ active (boolean)
                └─ optInDetails []
                    ├─ optInId (number)
                    ├─ optInDateISO (string)
                    ├─ optInExpiryDateISO (string)
                    ├─ optInEventLogId (number)
                    ├─ optInProcessingDateISO (string)
                    └─ active (boolean)

Example response

{
    "memberId": 388757266,
    "promotions": [
        {
            "promotionId": 1133608813,
            "promotionName": "test-loyalty-promo-123",
            "programId": 2607,
            "startDateISO": "2026-03-01T00:00:00+05:30",
            "endDateISO": "2026-04-01T23:59:59+05:30",
            "timezoneName": "Asia/Kolkata",
            "promotionIdentifier": "2dac55ea-2ae8-486a-bed1-0c7992c2565c",
            "unifiedPromotionId": "abc12345-0000-4abc-8def-000000000000",
            "description": "test-loyalty-promo-123",
            "active": true,
            "promotionCustomFields": [
                { "key": "header-new", "value": "1234", "brandDefined": true },
                { "key": "xsx", "value": "4567", "brandDefined": true }
            ],
            "customerPromotionTimelines": [
                {
                    "enrollmentDetails": [
                        {
                            "enrollmentId": 222987,
                            "enrollmentDateISO": "2026-03-10T13:55:10+05:30",
                            "enrollmentExpiryDateISO": "2026-04-01T23:59:59+05:30",
                            "enrollEventLogId": 52208266,
                            "active": true,
                            "optInDetails": [
                                {
                                    "optInId": 185122,
                                    "optInDateISO": "2026-03-10T13:57:20+05:30",
                                    "optInExpiryDateISO": "2026-04-01T23:59:59+05:30",
                                    "optInEventLogId": 52208279,
                                    "optInProcessingDateISO": "2026-03-10T13:57:20+05:30",
                                    "active": true
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

Response parameters

Field	Type	Description
`.memberId`	Long	Unique identifier of the member.
`.promotions`	Array	List of promotion objects with full participation timeline details.
`..promotionId`	Long	Unique identifier of the promotion.
`..promotionName`	String	Name of the promotion.
`..programId`	Integer	Unique ID of the loyalty program the promotion belongs to.
`..startDateISO`	String	Indicates the promotion's start date and time in ISO 8601 format, returned in the server time zone. EU server example: 2026-03-01T00:00:00Z → 01 March 2026, 00:00:00 (UTC) India server example: 2026-03-01T00:00:00+05:30 → 01 March 2026, 00:00:00 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
`..endDateISO`	String	Indicates the promotion's end date and time in ISO 8601 format, returned in the server time zone. EU server example: 2026-04-01T23:59:59Z → 01 April 2026, 23:59:59 (UTC) India server example: 2026-04-01T23:59:59+05:30 → 01 April 2026, 23:59:59 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
`..timezoneName`	String	IANA timezone name used to format the promotion's dates (for example, `Asia/Kolkata`). Defaults to `Asia/Kolkata` if not configured.
`..promotionIdentifier`	String	Unique string identifier of the promotion.
`..unifiedPromotionId`	String	UUID that identifies the promotion in the Unified Promotions system.
`..description`	String	Promotion description.
`..active`	Boolean	Whether the promotion is currently active.
`..optInStartDateISO`	String	Indicates the start of the opt-in window in ISO 8601 format, returned in the server time zone. Returned only when an opt-in window is configured for the promotion. EU server example: 2026-03-01T00:00:00Z → 01 March 2026, 00:00:00 (UTC) India server example: 2026-03-01T00:00:00+05:30 → 01 March 2026, 00:00:00 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
`..optInEndDateISO`	String	Indicates the end of the opt-in window in ISO 8601 format, returned in the server time zone. Returned only when an opt-in window is configured for the promotion. EU server example: 2026-03-15T23:59:59Z → 15 March 2026, 23:59:59 (UTC) India server example: 2026-03-15T23:59:59+05:30 → 15 March 2026, 23:59:59 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
`..promotionCustomFields`	Array	Promotion-level key-value custom fields.
`...key`	String	Custom field name.
`...value`	String	Custom field value.
`...brandDefined`	Boolean	Whether the custom field was defined by the brand.
`..customerPromotionTimelines`	Array	Timeline entries representing the member's full participation history for this promotion.
`...enrollmentDetails`	Array	List of enrollment records for this timeline entry.
`....enrollmentId`	Long	Unique identifier of the enrollment record.
`....enrollmentDateISO`	String	Indicates the date and time the member enrolled, in ISO 8601 format, returned in the server time zone. EU server example: 2026-03-10T08:25:10Z → 10 March 2026, 08:25:10 (UTC) India server example: 2026-03-10T13:55:10+05:30 → 10 March 2026, 13:55:10 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
`....enrollmentExpiryDateISO`	String	Indicates the enrollment expiry date and time in ISO 8601 format, returned in the server time zone. EU server example: 2026-04-01T18:29:59Z → 01 April 2026, 18:29:59 (UTC) India server example: 2026-04-01T23:59:59+05:30 → 01 April 2026, 23:59:59 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
`....enrollEventLogId`	Long	Event log ID for the enrollment event.
`....active`	Boolean	Whether the enrollment is currently active.
`....optInDetails`	Array	List of opt-in records for this enrollment. Empty if the promotion does not require opt-in.
`.....optInId`	Long	Unique identifier of the opt-in record.
`.....optInDateISO`	String	Indicates the date and time the member opted in, in ISO 8601 format, returned in the server time zone. EU server example: 2026-03-10T08:27:20Z → 10 March 2026, 08:27:20 (UTC) India server example: 2026-03-10T13:57:20+05:30 → 10 March 2026, 13:57:20 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
`.....optInExpiryDateISO`	String	Indicates the opt-in expiry date and time in ISO 8601 format, returned in the server time zone. EU server example: 2026-04-01T18:29:59Z → 01 April 2026, 18:29:59 (UTC) India server example: 2026-04-01T23:59:59+05:30 → 01 April 2026, 23:59:59 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
`.....optInEventLogId`	Long	Event log ID for the opt-in event.
`.....optInProcessingDateISO`	String	Indicates the date and time the opt-in was processed by the system, in ISO 8601 format, returned in the server time zone. EU server example: 2026-03-10T08:27:20Z → 10 March 2026, 08:27:20 (UTC) India server example: 2026-03-10T13:57:20+05:30 → 10 March 2026, 13:57:20 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
`.....active`	Boolean	Whether the opt-in is currently active.

Error and warning codes

Code	Type	Description
310192	Error	Member not found for the given `memberId`. Use a valid `memberId`.
310194	Error	No `ACTIVE`, `PAUSED`, or `STOPPED` promotion found for the given `promotionId`. Use a valid `promotionId`.
310193	Error	No `ACTIVE`, `PAUSED`, or `STOPPED` promotion found for the given `promotionIdentifier`. Use a valid `promotionIdentifier`.
310196	Error	Invalid value for `memberEnrollmentStatus`. Supported values: `PENDING_ENROLLMENT`, `PENDING_OPT_IN`, `AVAILABLE_TO_REDEEM`, `REDEEMED`, `EXPIRED`.
500	Error	Internal server error. Retry the request after a short delay.