> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.littglobal.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.littglobal.com/_mcp/server. # Reverse Reward Points POST TBD/api/v2/users/reverse-reward-points Content-Type: application/json This API endpoint lets a partner (such as Konkrd) reverse points it previously added with Add Reward Points, for example when a policy is cancelled. It is called server to server: it is restricted to the partner's IP addresses and does not use a user API token. Each award can be reversed once. Repeating the request returns the original reversal. ### Request Body - `user_id` (string): The member's user ID. - `transaction_reference` (string): The reference used when the points were added. ### Response - `reward_point_transaction_id` (string): The ID of the reversal transaction. - `user_id` (string): The member's user ID. - `transaction_type` (string): `11` (Partner points reversal). - `description` (string): Copied from the original award. - `points` (integer): The negative number of points reversed, for example `-500`. - `transaction_reference` (string): The original reference with `:reversal` appended. - `created_at` (string): When the points were reversed. `status` is `error`, with a `message` explaining why, when no points were added with this reference for the member, or when the member no longer has enough points (already converted). Nothing is reversed in either case. Reference: https://docs.littglobal.com/litt-white-label/api-reference/reward-points/reverse-reward-points ## Request ### Body (application/json) This endpoint expects an object. - `api` (string, optional) - `data` (ApiV2UsersReverseRewardPointsPostRequestBodyContentApplicationJsonSchemaData, optional) ## Response ### 200 Reverse Reward Points - `message` (string, optional) - `api` (string, optional) - `status` (string, optional) - `data` (ApiV2UsersReverseRewardPointsPostResponsesContentApplicationJsonSchemaData, optional) ## Types ### ApiV2UsersReverseRewardPointsPostRequestBodyContentApplicationJsonSchemaData - `user_id` (string, optional) - `transaction_reference` (string, optional) ### ApiV2UsersReverseRewardPointsPostResponsesContentApplicationJsonSchemaData - `reward_point_transaction_id` (string, optional) - `user_id` (string, optional) - `transaction_type` (string, optional) - `description` (string, optional) - `points` (integer, optional) - `transaction_reference` (string, optional) - `updated_at` (datetime, optional) - `created_at` (datetime, optional) ## Examples **Request** ```json { "api": "reverse-reward-points", "data": { "user_id": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "transaction_reference": "KONKRD-AWARD-123" } } ``` **Response** ```json { "message": "Success", "api": "reverse-reward-points", "status": "success", "data": { "reward_point_transaction_id": "9fa1d805-f173-4ddc-971c-50b75030a3a", "user_id": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "transaction_type": "11", "description": "Health purchase", "points": -500, "transaction_reference": "KONKRD-AWARD-123:reversal", "updated_at": "2026-10-10T07:29:11.000000Z", "created_at": "2026-10-10T07:29:11.000000Z" } } ``` **SDK Code** ```python Reward Points_reverseRewardPoints_example import requests url = "https://tbd/api/v2/users/reverse-reward-points" payload = { "api": "reverse-reward-points", "data": { "user_id": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "transaction_reference": "KONKRD-AWARD-123" } } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Reward Points_reverseRewardPoints_example const url = 'https://tbd/api/v2/users/reverse-reward-points'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"api":"reverse-reward-points","data":{"user_id":"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada","transaction_reference":"KONKRD-AWARD-123"}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Reward Points_reverseRewardPoints_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://tbd/api/v2/users/reverse-reward-points" payload := strings.NewReader("{\n \"api\": \"reverse-reward-points\",\n \"data\": {\n \"user_id\": \"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada\",\n \"transaction_reference\": \"KONKRD-AWARD-123\"\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Reward Points_reverseRewardPoints_example require 'uri' require 'net/http' url = URI("https://tbd/api/v2/users/reverse-reward-points") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{\n \"api\": \"reverse-reward-points\",\n \"data\": {\n \"user_id\": \"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada\",\n \"transaction_reference\": \"KONKRD-AWARD-123\"\n }\n}" response = http.request(request) puts response.read_body ``` ```java Reward Points_reverseRewardPoints_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://tbd/api/v2/users/reverse-reward-points") .header("Content-Type", "application/json") .body("{\n \"api\": \"reverse-reward-points\",\n \"data\": {\n \"user_id\": \"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada\",\n \"transaction_reference\": \"KONKRD-AWARD-123\"\n }\n}") .asString(); ``` ```php Reward Points_reverseRewardPoints_example request('POST', 'https://tbd/api/v2/users/reverse-reward-points', [ 'body' => '{ "api": "reverse-reward-points", "data": { "user_id": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "transaction_reference": "KONKRD-AWARD-123" } }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Reward Points_reverseRewardPoints_example using RestSharp; var client = new RestClient("https://tbd/api/v2/users/reverse-reward-points"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"api\": \"reverse-reward-points\",\n \"data\": {\n \"user_id\": \"2ef350a0-f8cd-4730-8e29-9b5fc5db0ada\",\n \"transaction_reference\": \"KONKRD-AWARD-123\"\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Reward Points_reverseRewardPoints_example import Foundation let headers = ["Content-Type": "application/json"] let parameters = [ "api": "reverse-reward-points", "data": [ "user_id": "2ef350a0-f8cd-4730-8e29-9b5fc5db0ada", "transaction_reference": "KONKRD-AWARD-123" ] ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://tbd/api/v2/users/reverse-reward-points")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```