Updated on 2026-08-14

core/datasource/src/main/java/com/tangem/datasource/api/pay/TangemPayApi.kt

@@ -202,4 +202,10 @@ interface TangemPayApi {
         @Header("Authorization") authHeader: String,
         @Header("Accept-Language") language: String,
     ): ApiResponse<CashbackAccrualDocsResponse>
+
+    @GET("v1/customer/cashback/history")
+    suspend fun getCashbackHistory(
+        @Header("Authorization") authHeader: String,
+        @Query("months") months: Int,
+    ): ApiResponse<CashbackHistoryResponse>
 }

core/datasource/src/main/java/com/tangem/datasource/api/pay/models/response/CashbackHistoryResponse.kt

@@ -0,0 +1,25 @@
+package com.tangem.datasource.api.pay.models.response
+
+import com.squareup.moshi.Json
+import com.squareup.moshi.JsonClass
+import java.math.BigDecimal
+
+/**
+ * Response from `GET /v1/customer/cashback/history`.
+ *
+ * Confirmed cashback grouped by calendar month, ordered oldest to newest. Drives the monthly
+ * earnings histogram on the Cashback screen.
+ */
+@JsonClass(generateAdapter = true)
+data class CashbackHistoryResponse(
+    @Json(name = "currency") val currency: String?,
+    @Json(name = "items") val items: List<Item>?,
+) {
+
+    @JsonClass(generateAdapter = true)
+    data class Item(
+        @Json(name = "year") val year: Int,
+        @Json(name = "month") val month: Int,
+        @Json(name = "confirmed_amount") val confirmedAmount: BigDecimal?,
+    )
+}