Get Point Allocation Details by Event ID

The API retrieves information about points allocated to customers based on the event ID.

🚧

Note

This is a private API and is accessible only through Neo dataflows

Prerequisites

  • Access to Neo
  • Basic or OAuth authentication details
  • Access group resource - NA

Resource information

URI to be used in Neo dataflow/das/getPaDetailsByEventId
HTTP methodGET
Pagination supported?Yes
Rate limitBased on Neo
Batch supportNA

Request Query Parameters

Parameter(Parameters marked with * are mandatory) Data Type Description

entity_id*

String/Integer based on event_type_id

Specifies the identifier used to fetch event-specific details. This can be one of the following:

  • The event ID of the event, such as TransactionAdd or a behavioural event
  • The unique ID of the event
  • The server-generated request ID of a behavioural event

customer_id*

Long

Unique Customer ID

event_type_id*

Integer

Unique identifier for the type of event.

page

Integer

Retrieve details of a specific page. Page count starts from 1.
Example: page=2 retrieves data on page 2.

count

Integer

Number of results to display per page. The default value is 10. The maximum supported value is 100.

Response Parameters

ParameterData TypeDescription
till_idIntegerIdentifier of the store/till where the transaction occurred
point_category_idIntegerUnique identifier that indicates the type or category of points awarded or deducted
program_idIntegerID of the loyalty program
event_log_idIntegerID of the event log that recorded the transaction
event_type_idIntegerID indicating the type of event
points_source_type_idIntegerID of the source type from which points were earned
original_pointsIntegerNumber of points initially awarded
awarded_dateLongTimestamp when the points were awarded (in milliseconds)
returned_exclusive_valueIntegerExclusive value of points returned
points_source_idIntegerID of the source entity awarding the points
idIntegerUnique ID of the point allocation entry
cps_idIntegerID of the customer program state
original_customer_idIntegerID of the customer before the merge or update
expiry_strategy_idIntegerID of the strategy used to determine point expiry
returned_valueIntegerTotal value of returned points
redeemed_exclusive_valueIntegerExclusive value of redeemed points
expiry_dateLongExpiry timestamp of the awarded points (in milliseconds)
auto_update_timeLongTimestamp of the last auto-update to the entry
redeemed_valueIntegerValue of points redeemed
expired_exclusive_valueIntegerExclusive value of points that have expired
allocation_strategy_idIntegerID of the strategy used to allocate points
points_valueIntegerTotal value of the points awarded
org_idIntegerOrganization ID
expired_valueIntegerValue of points that expired
customer_idIntegerID of the customer to whom the points are allocated
points_exclusiveIntegerExclusive points that are available
statusStringCurrent status of the point entry
[
    {
        "till_id": 50140377,
        "point_category_id": 17383,
        "program_id": 2282,
        "event_log_id": 10072893,
        "event_type_id": 15,
        "points_source_type_id": 1,
        "original_points": 0,
        "awarded_date": 1648489472000,
        "returned_exclusive_value": 0,
        "points_source_id": 2148434124,
        "id": 31787856,
        "cps_id": 51368957,
        "original_customer_id": 374819205,
        "expiry_strategy_id": 105602,
        "returned_value": 0,
        "redeemed_exclusive_value": 0,
        "expiry_date": 1648578599000,
        "auto_update_time": 1648596913000,
        "redeemed_value": 0,
        "expired_exclusive_value": 50,
        "allocation_strategy_id": 105773,
        "points_value": 0,
        "org_id": 50914,
        "expired_value": 0,
        "customer_id": 374819205,
        "points_exclusive": 50,
        "status": "EXPIRED"
    }
]

Error Code

Error CodeDescription
400Bad Request
404Not Found
500Internal Server Error
Language
Credentials
Basic
base64
:
URL
Click Try It! to start a request and see the response here!