curl --request GET \
--url "https://api.yukoapp.com/api/v1/public/customers/transactions?customer_id=9049402769586&entry_type=credit&per_page=20" \
--header "Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
const customerId = "9049402769586";
const params = new URLSearchParams({ entry_type: "credit", per_page: 20 });
const response = await fetch(
`https://api.yukoapp.com/api/v1/public/customers/transactions?customer_id=${customerId}&${params}`,
{
method: "GET",
headers: {
Authorization: "Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
},
}
);
const data = await response.json();
$customerId = "9049402769586";
$query = http_build_query(["entry_type" => "credit", "per_page" => 20]);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.yukoapp.com/api/v1/public/customers/transactions?customer_id={$customerId}&{$query}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
{
"data": [
{
"id": "d4e5f6a7-b8c9-0123-defa-b01234567890",
"customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
"entry_type": "credit",
"points": 100,
"action_type": "purchase",
"status": "active",
"description": null,
"source": null,
"transacted_at": "2026-02-15T08:30:00+00:00",
"created_at": "2026-02-15T08:30:00+00:00"
},
{
"id": "e5f6a7b8-c9d0-1234-efab-c01234567890",
"customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
"entry_type": "credit",
"points": 50,
"action_type": "signup",
"status": "active",
"description": null,
"source": null,
"transacted_at": "2024-06-01T10:00:00+00:00",
"created_at": "2024-06-01T10:00:00+00:00"
}
],
"meta": {
"pagination": {
"current_page": 1,
"per_page": 20,
"total": 2,
"last_page": 1,
"has_more": false
}
}
}
{
"error": {
"code": "not_found",
"message": "Customer not found"
}
}
{
"error": {
"code": "invalid_token",
"message": "Invalid or revoked API token"
}
}
Customers
List points transactions
Retrieves a paginated list of points transactions for a customer, newest first.
GET
/
public
/
customers
/
transactions
curl --request GET \
--url "https://api.yukoapp.com/api/v1/public/customers/transactions?customer_id=9049402769586&entry_type=credit&per_page=20" \
--header "Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
const customerId = "9049402769586";
const params = new URLSearchParams({ entry_type: "credit", per_page: 20 });
const response = await fetch(
`https://api.yukoapp.com/api/v1/public/customers/transactions?customer_id=${customerId}&${params}`,
{
method: "GET",
headers: {
Authorization: "Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
},
}
);
const data = await response.json();
$customerId = "9049402769586";
$query = http_build_query(["entry_type" => "credit", "per_page" => 20]);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.yukoapp.com/api/v1/public/customers/transactions?customer_id={$customerId}&{$query}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
{
"data": [
{
"id": "d4e5f6a7-b8c9-0123-defa-b01234567890",
"customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
"entry_type": "credit",
"points": 100,
"action_type": "purchase",
"status": "active",
"description": null,
"source": null,
"transacted_at": "2026-02-15T08:30:00+00:00",
"created_at": "2026-02-15T08:30:00+00:00"
},
{
"id": "e5f6a7b8-c9d0-1234-efab-c01234567890",
"customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
"entry_type": "credit",
"points": 50,
"action_type": "signup",
"status": "active",
"description": null,
"source": null,
"transacted_at": "2024-06-01T10:00:00+00:00",
"created_at": "2024-06-01T10:00:00+00:00"
}
],
"meta": {
"pagination": {
"current_page": 1,
"per_page": 20,
"total": 2,
"last_page": 1,
"has_more": false
}
}
}
{
"error": {
"code": "not_found",
"message": "Customer not found"
}
}
{
"error": {
"code": "invalid_token",
"message": "Invalid or revoked API token"
}
}
Results are sorted by
created_at, newest first. The list also includes the credit entry recorded when a customer redeems a store credit reward (action_type store_credit). For that entry, points is the store credit amount (rounded down to a whole number), not a number of points; the points spent appear as a separate debit entry.
Requires the
read:transactions scope. See Scopes.Query parameters
string
required
The platform customer ID, for example the Shopify customer ID.
enum<string>
Return only transactions of this type. One of
credit, debit.integer
default:20
The number of results per page. Must be between
1 and 100.integer
default:1
The page number to retrieve. See Classic pagination.
Response
object[]
The transactions on this page.
Show transaction properties
Show transaction properties
string<uuid>
Unique identifier for the transaction.
string<uuid>
The UUID of the customer this transaction belongs to.
enum<string>
Whether points were added or removed. One of
credit, debit.integer
The number of points added or removed. Always a positive number; use
entry_type to determine direction.string
The action that generated this transaction, for example
purchase, signup, point_adjustment (manual or REST API adjustments) or the reward type for redemptions.enum<string>
The current status of the transaction. One of
active, on_hold, used, failed.string | null
A human-readable description of the transaction, if provided.
string | null
The source that created this transaction, for example
rest_api.string<date-time>
When the transaction occurred.
string<date-time>
When the transaction record was created.
object
Errors
| Status | Code | When |
|---|---|---|
401 | missing_token, invalid_token | The API key is missing, wrong or revoked. |
403 | insufficient_scope | The key doesn’t have read:transactions. |
404 | not_found | No customer matches customer_id (Customer not found). |
429 | The key exceeded the rate limit. |
curl --request GET \
--url "https://api.yukoapp.com/api/v1/public/customers/transactions?customer_id=9049402769586&entry_type=credit&per_page=20" \
--header "Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
const customerId = "9049402769586";
const params = new URLSearchParams({ entry_type: "credit", per_page: 20 });
const response = await fetch(
`https://api.yukoapp.com/api/v1/public/customers/transactions?customer_id=${customerId}&${params}`,
{
method: "GET",
headers: {
Authorization: "Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
},
}
);
const data = await response.json();
$customerId = "9049402769586";
$query = http_build_query(["entry_type" => "credit", "per_page" => 20]);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.yukoapp.com/api/v1/public/customers/transactions?customer_id={$customerId}&{$query}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
{
"data": [
{
"id": "d4e5f6a7-b8c9-0123-defa-b01234567890",
"customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
"entry_type": "credit",
"points": 100,
"action_type": "purchase",
"status": "active",
"description": null,
"source": null,
"transacted_at": "2026-02-15T08:30:00+00:00",
"created_at": "2026-02-15T08:30:00+00:00"
},
{
"id": "e5f6a7b8-c9d0-1234-efab-c01234567890",
"customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
"entry_type": "credit",
"points": 50,
"action_type": "signup",
"status": "active",
"description": null,
"source": null,
"transacted_at": "2024-06-01T10:00:00+00:00",
"created_at": "2024-06-01T10:00:00+00:00"
}
],
"meta": {
"pagination": {
"current_page": 1,
"per_page": 20,
"total": 2,
"last_page": 1,
"has_more": false
}
}
}
{
"error": {
"code": "not_found",
"message": "Customer not found"
}
}
{
"error": {
"code": "invalid_token",
"message": "Invalid or revoked API token"
}
}