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).
Example request
curl --location 'https://eu.api.capillarytech.com/v2/customers/564955098/pointsTransfers' \
--header 'Authorization: Basic =' \
--header 'Cookie: _cfuvid=SPpJZvR8VvAMacotHKvjCBzkT.A38OIejYNSsGOXido-1757310494558-0.0.1.1-604800000'Prerequisites
- Basic or OAuth credentials
- Read access to Points access group resource
Rate limit
- Demo and Testing Clusters: 1,000 requests per minute per API key
- Other Organizations: The rate limit is brand-specific.
To modify the limit, create a ticket with the Capillary Product support team.
Sample API cURL
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. |
| X-CAP-API-OAUTH-TOKEN | This header is a custom authentication header used to pass the OAuth access token for API authentication. Refer to https://docs.capillarytech.com/reference/oauth#/ |
Query parameter
| Parameter | Type | Required | Description |
|---|---|---|---|
| programId | integer | Optional | Filters transfers for a specific loyalty program; typically needed only for multi-program orgs. |
| entityType | string | Optional | Entity context; defaults to CUSTOMER when not provided |
| limit | integer | Optional | Maximum number of records to return per page. Default value - 10 |
| offset | integer | Optional | Number of records to skip before starting to return results (zero-based). Default value - 0 |
| page | integer | Optional | Page number to fetch (alternative to offset). Overrides offset if both are provided. Default value - 1 |
| sortBy | string | Optional | Field to sort by (e.g., pointsTransferDate, pointsTransferred). |
| sortOrder | string | Optional | Sort direction: asc (ascending) or desc (descending). Default: desc. |
Path parameter
| Parameter | Type | Required | Description |
|---|---|---|---|
| userId | integer | Yes | Unique ID of the customer whose points transfer summary is requested. |
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. |
Example response
{
"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": []
}{
"data": [
{
"toEntityId": 564955098,
"toEntityType": "CUSTOMER",
"fromEntityId": 564955097,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-03-26 17:49:22",
"pointsTransferred": 40.0,
"transferId": 1035937,
"transferType": "ADDITION",
"transferredFrom": {
"userId": 564955097,
"firstName": "testgrp1",
"lastName": "testgrpv2"
},
"transferredTo": {
"userId": 564955098,
"firstName": "",
"lastName": ""
},
"notes": "Transferred on 28 feb 2025",
"programName": "DocDemoDefaultProgram"
},
{
"toEntityId": 564955098,
"toEntityType": "CUSTOMER",
"fromEntityId": 564955097,
"fromEntityType": "CUSTOMER",
"pointsTransferDate": "2025-03-26 17:49:21",
"pointsTransferred": 40.0,
"transferId": 1035936,
"transferType": "ADDITION",
"transferredFrom": {
"userId": 564955097,
"firstName": "testgrp1",
"lastName": "testgrpv2"
},
"transferredTo": {
"userId": 564955098,
"firstName": "",
"lastName": ""
},
"notes": "Transferred on 28 feb 2025",
"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 |