Get Point Allocation Details by Event ID

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

🚧

Note

This API is a private API that has been exposed through Neo and made public.

Prerequisites

  • Basic or OAuth authentication details
  • Access group resource - NA
  • Header x-cap-neo-dag-scope set to global

Resource information

URI/x/neo/pointsAllocation/event
HTTP methodGET
Pagination supported?Yes
Rate limitBased on Neo
Batch supportNA

Example request

curl --location 'https://eu.api.capillarytech.com/x/neo/pointsAllocation/event?entity_id=890697432&customer_id=566135941&event_type_id=15' \
--header 'x-cap-neo-dag-scope: global' \
--header 'Authorization: Basic ZGl2eWFfZG9jOmVjMzFiZWY3ZTNhNTdlYTI0YTYyZTZm' \
--header 'Cookie: _cfuvid=nkdqRjD57tAqwEjeR8HFwvTH0opPqch.Nf9wK366n4k-1758113514799-0.0.1.1-604800000'

Request query parameters

Parameter

Data Type

Required

Description

entity_id

String

Yes

Specifies the identifier used to fetch event-specific details. See the list below.

customer_id

Long

Yes

Unique Customer ID

event_type_id

Integer

Yes

Unique identifier for the type of event. This depends on the kind of event. Refer to thetable belowfor the event type ID associated with your event.

page

Integer

No

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

count

Integer

No

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


Event type ID

Event TypeID
NewBill1
CustomerRegistration2
PointsRedemption3
VoucherRedemption4
ReturnBill5
TrackerConditionSuccess6
SocialConnect7
NewBillDVS8
TransactionFinished9
ReferralPostProcessing10
TransactionUpdate11
CustomerUpdate12
EmailOpen13
EmailClick14
TransactionAdd15
DelayedAccrual16
Scan17
GroupTransactionAdd18
GroupTransactionUpdate19
GroupReturnBill20
GroupMemberJoin21
GroupMemberLeave22
GenericEvent23
PointsTransfer24
TargetCompleted25
PointsRedemptionReversal26
PartnerProgramDeLinking27
PartnerProgramLinking28
PartnerProgramTierUpdate29
TierReassessment30
PointsContributionToGroup31
AllocateGoodwillPoints32
AllocatePromotionPoints33
PointsExpiry34
PointsExpiryReminder35
TierDowngrade36
TierDowngradeReminder37
TierDowngradeOnReturn38
PromotionPointsExpiryAdjustment39
PartnerProgramExpiryReminder40
MergeCustomer41
BulkAllocatePoints42
TrackerDataImport43
TrackerReturnsDataImport44
CustomerProgramEnrollmentImport45
CustomerPromotionImport46
BillPointsPromotionImport47
ExpireBillPromotionImport48
ExpireCustomerPromotionImport49
LineItemsPointsPromotionImport50
RedemptionsImport51
TransactionDeductionImport52
TransactionMLPImport53
PartnerProgramLinkingImport54
PartnerProgramDeLinkingImport55
PartnerProgramTierRenewImport56
SuppPartnerProgramLinkingImport57
SuppPartnerProgramDelinkingImport58
SuppPartnerProgramUpdateImport59
WarehouseBasedSlabImport60
LoyaltyBenefitsImport61
BillImport62
BillLineItemsImport63
CustomerImport64
HistoricalPointsImport65
PartnerProgramTierUpdateImport66
PointsExpiryUpdateByRefTypeAndIdImport67
UpdatePromotionsPointsExpiryDateImport68
PointsLedgerBulkJob69
UpdatePointsExpiryInDateRangeImport70
UserGroup2Create71
LoyaltySlabEarlyExpiry72
TransactionCleanupImport73
OutlierStatusImport74
ManualPointsAdjustment75
ManualPointsAdjustmentImport76
ManualPointsConversion77
ReturnTargetCompletedEvent78
IssuePromotionForEntityEvent79
PointsLedgerRecreation80
ConvertPointsToReward81
EarnPromotionForEntityEvent82
RevokeIssuePromotionEvent83
RevokeEarnPromotionEvent84
ManualSlabAdjustment85
ManualCurrencyAllocation86
TierAgnosticPartnerProgramExpiry87
TierDowngradeEvent88
TierRenewEvent89

Sample request

curl --location 'https://nightly.api.capillarytech.com/x/neo/pointsAllocation/event?entity_id=hfjWDK0dek&customer_id=374819205&event_type_id=15' \
--header 'Content-Type: application/json' \
--header 'x-cap-neo-dag-scope: global' \
--header 'Authorization: Basic MDcxNTJkMjM0Yjcw' \
--header 'Cookie: _cfuvid=aipDF8qJJabNkC6ofNg0_4.3nMtpbVSQI9mVehJNjMw-1749448275226-0.0.1.1-604800000; _cfuvid=5YjVQ2SkBWELRCgtes5wkbXKRpcYNHnhogmQk5roBL4-1750314849268-0.0.1.1-604800000'

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

Sample response

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

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!