Retrieve member transaction data, aggregated and grouped by year.
1 min
GET
https://api.b.preview.loyaltyservices.io/api/v3/members/{memberIdentifier}/transactions/aggregates/yearly
Path Parameters
- memberIdentifierstringrequiredExampleDescriptionMin Length1Max Length200
Query Parameters
- fromYearinteger<int32>ExampleDescriptionFormatint32
- toYearinteger<int32>ExampleDescriptionFormatint32
Responses
200
- TransactionAggregateYearGroup[]Description
- yearinteger<int32>ExampleDescriptionFormatint32
- baseEarningsTransactionAggregateCounter
- pointsobject[]Description
- pointCategorystringExampleDescription
- amountnumberExampleDescription
- countersCounter[]Description
- counterTypeCodestringDescription
- counterValuenumberDescription
- bonusEarningsTransactionAggregateCounter
- pointsobject[]Description
- pointCategorystringExampleDescription
- amountnumberExampleDescription
- countersCounter[]Description
- counterTypeCodestringDescription
- counterValuenumberDescription
- partnerEarningsTransactionAggregateCounter
- pointsobject[]Description
- pointCategorystringExampleDescription
- amountnumberExampleDescription
- countersCounter[]Description
- counterTypeCodestringDescription
- counterValuenumberDescription
- promotionEarningsTransactionAggregateCounter
- pointsobject[]Description
- pointCategorystringExampleDescription
- amountnumberExampleDescription
- countersCounter[]Description
- counterTypeCodestringDescription
- counterValuenumberDescription
- tierRolloverTransactionAggregateCounter
- pointsobject[]Description
- pointCategorystringExampleDescription
- amountnumberExampleDescription
- countersCounter[]Description
- counterTypeCodestringDescription
- counterValuenumberDescription
400
- ErrorResponse
- errorsValidationError[]Description
- codestringDescription
- fieldNamestringDescription
- messagestringDescription
- messageParametersobject[]Description
401
403
500
curl
curl --request GET \
--url https://api.b.preview.loyaltyservices.io/api/v3/members/{memberIdentifier}/transactions/aggregates/yearly \
--header 'accept: application/json'javascript
var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
var requestOptions = {
method: 'GET',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://api.b.preview.loyaltyservices.io/api/v3/members/{memberIdentifier}/transactions/aggregates/yearly", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));ruby
require "uri"
require "json"
require "net/http"
url = URI("https://api.b.preview.loyaltyservices.io/api/v3/members/{memberIdentifier}/transactions/aggregates/yearly")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
response = https.request(request)
puts response.read_body
python
import requests
import json
url = "https://api.b.preview.loyaltyservices.io/api/v3/members/{memberIdentifier}/transactions/aggregates/yearly"
payload = {}
headers = {
'accept': 'application/json',
'content-type': 'application/json'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
200
// Success
[
{
"year": 2025,
"baseEarnings": {
"points": [
{
"pointCategory": "Points",
"amount": 1000
}
],
"counters": [
{
"counterTypeCode": "",
"counterValue": 0
}
]
},
"bonusEarnings": {
"points": [
{
"pointCategory": "Points",
"amount": 1000
}
],
"counters": [
{
"counterTypeCode": "",
"counterValue": 0
}
]
},
"partnerEarnings": {
"points": [
{
"pointCategory": "Points",
"amount": 1000
}
],
"counters": [
{
"counterTypeCode": "",
"counterValue": 0
}
]
},
"promotionEarnings": {
"points": [
{
"pointCategory": "Points",
"amount": 1000
}
],
"counters": [
{
"counterTypeCode": "",
"counterValue": 0
}
]
},
"tierRollover": {
"points": [
{
"pointCategory": "Points",
"amount": 1000
}
],
"counters": [
{
"counterTypeCode": "",
"counterValue": 0
}
]
}
}
]400
// Bad request
{
"errors": [
{
"code": "",
"fieldName": "",
"message": "",
"messageParameters": [
{}
]
}
]
}401
// Unauthorized
403
// Forbidden
500
// Internal error