get https://{host}/v2/customers//pointsTransfers
Retrieves points transfer summary of a customer.
This includes points that are transferred from the customer account to another customer’s account (Deduction) and points that are received from another customer’s account (Addition).
Prerequisites
- Basic or OAuth credentials
- Read access to Points access group resource
API endpoint example
https://eu.api.capillarytech.com/v2/customers/343015431/pointsTransfers
curl --location 'https://eu.api.capillarytech.com/v2/customers/565039505/pointsTransfers' \
--header 'Authorization: Basic c2FudC5wXzEyMzpiMmVhMGFhYWI1ZThmODg5ZTAzNGE2NjA5NTIwM2FlNw==' \
--header 'Cookie: _cfuvid=uEUwrBAfGGgkRhH8C6wGyc6ShByhFRsEdpQj1e8WSGU-1750831646379-0.0.1.1-604800000'
Resource information
URI | v2/customers/34301543/pointsTransfers |
---|---|
HTTP method | GET |
Authentication | Basic |
Pagination support | Yes |
Rate limit | Yes |
Batch Support | No |
Request Headers
Header Key | Description |
---|---|
Authorization | Bearer token for authentication. Example: Bearer <your_access_token>. |
Content-Type | Specifies the media type of the request. Use application/json for JSON. |
Accept | Defines the response format. Example: application/json or application/xml. |
X-Capillary-OrgId | Unique organization ID for which the API is being called. |
X-Capillary-App-Key | Application key for API access. |
Query parameter
Parameter | Type | Description |
---|---|---|
limit | int | Maximum number of records to return per page. Default value - 10 |
offset | int | Number of records to skip before starting to return results (zero-based). Default value - 0 |
page | int | Page number to fetch (alternative to offset). Overrides offset if both are provided. Default value - 1 |
sortBy | string | Field to sort by (e.g., pointsTransferDate, pointsTransferred). |
sortOrder | string | Sort direction: asc (ascending) or desc (descending). Default: desc . |
Response Parameter
Parameter | Type | Description |
---|---|---|
toEntityId | long | Unique ID of the recipient entity (customer or group). |
toEntityType | string | Type of the recipient entity (e.g., "CUSTOMER"). |
fromEntityId | long | Unique ID of the sender entity (customer or group). |
fromEntityType | string | Type of the sender entity (e.g., "CUSTOMER"). |
pointsTransferDate | string | Timestamp of the points transfer (format: YYYY-MM-DD HH:MM:SS). |
pointsTransferred | double | Number of points transferred. |
transferId | long | Unique ID for the transfer transaction. |
transferType | string | Type of transfer (e.g., "DEDUCTION" for outgoing, "ADDITION" for incoming). |
transferredFrom | object | Details of the sender: |
userId | long | Sender's unique ID. |
firstName | string | Sender's first name |
lastName | string | Sender's last name |
transferredTo | object | Details of the recipient: |
userId | long | Recipient's unique ID. |
firstName | string | Recipient's first name |
lastName | string | Recipient's last name |
notes | string | Additional notes or comments for the transfer (if provided). |
programName | string | Name of the loyalty program associated with the transfer. |
{
"data": [
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-06 13:33:40",
"pointsTransferred": 20.0,
"transferId": 1038007,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-06 11:24:48",
"pointsTransferred": 20.0,
"transferId": 1038004,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-03 06:59:07",
"pointsTransferred": 20.0,
"transferId": 1037928,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-02 10:59:56",
"pointsTransferred": 20.0,
"transferId": 1037907,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-02 10:57:47",
"pointsTransferred": 20.0,
"transferId": 1037906,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-02 10:56:48",
"pointsTransferred": 200.0,
"transferId": 1037905,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-02 10:51:43",
"pointsTransferred": 200.0,
"transferId": 1037904,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-02 10:49:00",
"pointsTransferred": 200.0,
"transferId": 1037903,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-02 10:24:15",
"pointsTransferred": 20.0,
"transferId": 1037901,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-02 10:24:14",
"pointsTransferred": 2000.0,
"transferId": 1037898,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-02 10:24:13",
"pointsTransferred": 2000.0,
"transferId": 1037894,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 565039506,
"toEntityType": "CUSTOMER",
"fromEntityId": 565039505,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-06-02 07:24:58",
"pointsTransferred": 2000.0,
"transferId": 1037890,
"transferType": "DEDUCTION",
"transferredFrom": {
"userId": 565039505,
"firstName": "",
"lastName": ""
},
"transferredTo": {
"userId": 565039506,
"firstName": "Madhurima",
"lastName": "Basak"
},
"notes": "",
"programName": "DocDemoDefaultProgram"
}
],
"warnings": [],
"errors": []
}
API specific error code
Error Code | Description | Reason |
---|---|---|
814 | No Results Found | Invalid query parameter passed |
8015 | Customer not found for the given identifiers | Invalid userId passed |
8069 | Merged customer found | API request is made for a customer who has been merged |