Points

If there is a Loyalty program managed by CRM CareCloud based on points collection to a customer account, the points transactions and records like points collection and points redemption can be managed by this resource.

Available methods

All available methods for resource points

HTTP method Endpoint Description
[badge-blue GET] /points Get information about all point records
[badge-blue GET] /points/{point_id} Get information about a specific point record

Available methods with sub-resources

All available methods for sub-resources of resource points.

HTTP method Endpoint Description
[badge-blue GET] /points/{point_id}/purchases List of all purchases tied to the point record

Actions

Action methods for resource points

HTTP method Endpoint Description
[badge-green POST] /points/actions/reduce-points Redemption of points. This POST creates a new point redemption record.
[badge-green POST] /points/actions/assign-points Collection of points. This POST creates a new point collection record.

Action methods are available only in Enterprise interface.


Get all point records

Get a list of all point transactions, point collections and redemptions
[badge-blue GET] /points

Query string

Parameter name Type Description Mandatory (Yes/No)
count integer The number of records to return.
Default value is 100.
No
offset integer The number of records from a collection to skip.
Default value is 0.
No
sort_field string One of the query string parameters for sorting.
Response is sorted by the specified field.
No
sort_direction string Direction of sorting the response list.
Possible values are: ASC / DESC
No
customer_id string The unique id of the customer No
point_type_id string The unique id of a point type No
create_point_time_from string Date and time from of the create point record (YYYY-MM-DD HH:MM:SS) No
create_point_time_to string Date and time to of the create point record (YYYY-MM-DD HH:MM:SS) No

Response

Status code: 200 OK
Output structure : object

Parameter name Type Description
points Point[] List of the point records
total_items integer Count of all found point records


Get a point record

Get information about a specific point transaction
[badge-blue GET] /points/{point_id}

Path parameters

Parameter name Type Description
point_id string The unique id for the point record

Response

Status code: 200 OK
Output structure : Point


Points redemption

New point redemption record is created.
[badge-green POST] /points/actions/reduce-points

Request

Parameter name Type Description Mandatory (Yes/No)
amount float Number of redeemed points. Yes
customer_id string The unique id of the customer. Yes
partner_id string The unique id of the partner. No

Response

Status code: 204 No Content


Assign of points

Creates a new point collection record with the corresponding value
[badge-green POST] /points/actions/assign-points

Request

Parameter name Type Description Mandatory (Yes/No)
amount float The number of collected points. Yes
customer_id string The unique id of the customer. Yes
partner_id string The unique id of the partner. No

Response

Status code: 204 No Content