List customer activities

curl --request GET \
  --url "https://api.yukoapp.com/api/v1/public/customers/activities?customer_id=9049402769586?per_page=20" \
  --header "Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const customerId = "9049402769586";
const params = new URLSearchParams({ per_page: 20 });

const response = await fetch(
  `https://api.yukoapp.com/api/v1/public/customers/activities?customer_id=${customerId}?${params}`,
  {
    method: "GET",
    headers: {
      Authorization: "Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    },
  }
);

const data = await response.json();

$customerId = "9049402769586";
$query = http_build_query(["per_page" => 20]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.yukoapp.com/api/v1/public/customers/activities?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": "f7a8b9c0-d1e2-3456-fabc-d01234567890",
      "customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
      "activity_type": "purchase",
      "source_type": "loyalty_campaigns",
      "source_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "entry_type": "credit",
      "points": 100,
      "earning_type": "points",
      "metadata": {
        "earning_value": 100,
        "earning_type": "points",
        "entry_type": "credit"
      },
      "created_at": "2026-02-15T08:30:00.000Z"
    },
    {
      "id": "e6b7c8d9-e0f1-2345-efab-c01234567890",
      "customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
      "activity_type": "point_adjustment",
      "source_type": "users",
      "source_id": null,
      "entry_type": "credit",
      "points": 50,
      "earning_type": "points",
      "metadata": {
        "description": "Bonus for completing a survey",
        "source": "rest_api"
      },
      "created_at": "2026-02-10T12:00:00.000Z"
    }
  ],
  "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"
  }
}

Retrieves a paginated list of loyalty activities for a customer — including points earned, rewards redeemed, tier changes, and manual adjustments. Results are sorted by created_at in descending order. GET /public/customers/activities

Authorizations

Authorization string header required Bearer authentication header of the form Bearer <token>, where <token> is your REST API token.

Required Scope

activities:read This endpoint requires the activities scope with Read Access. Configure token scopes in Settings → Integrations → REST API.

Query Parameters

customer_id string required The platform customer ID (e.g. Shopify customer ID) Example: "9049402769586"

Query Parameters

source_type enum<string> Filter results to activities from the specified source. Available options: loyalty_campaigns, loyalty_rewards, loyalty_customer_rewards, loyalty_tiers, loyalty_tier_benefits, users, loyalty_transactions, referral_transactions activity_type string Filter results to a specific activity type (e.g. purchase, point_adjustment, reward_used). Example: "purchase" per_page integer default: 20 The number of results per page. Required range: 1 <= x <= 100 page integer default: 1 The page number to retrieve.

Response

200 - application/json data object[] Hide child attributes data.id string<uuid> Unique UUID identifier for the activity. Example: "f7a8b9c0-d1e2-3456-fabc-d01234567890" data.customer_id string<uuid> The UUID of the customer this activity belongs to. Example: "63a2c89a-9936-4bc0-9d5f-93db46110b76" data.activity_type string The type of action that occurred. Example: "purchase" data.source_type string The module or entity that generated this activity. Example: "loyalty_campaigns" data.source_id string<uuid> | null The UUID of the source record (e.g. campaign, reward) that triggered this activity. Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890" data.entry_type enum<string> | null Whether the activity resulted in a points credit or debit. Available options: credit, debit Example: "credit" data.points integer The number of points involved in this activity. Example: 100 data.earning_type string | null The type of earning (e.g. points, store_credit). Example: "points" data.metadata object Additional details about the activity. Structure varies by activity_type. data.created_at string<date-time> Example: "2026-02-15T08:30:00.000Z" meta object Hide child attributes meta.pagination object Hide child attributes meta.pagination.current_page integer Example: 1 meta.pagination.per_page integer Example: 20 meta.pagination.total integer Example: 12 meta.pagination.last_page integer Example: 1 meta.pagination.has_more boolean Example: false

curl --request GET \
  --url "https://api.yukoapp.com/api/v1/public/customers/activities?customer_id=9049402769586?per_page=20" \
  --header "Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

const customerId = "9049402769586";
const params = new URLSearchParams({ per_page: 20 });

const response = await fetch(
  `https://api.yukoapp.com/api/v1/public/customers/activities?customer_id=${customerId}?${params}`,
  {
    method: "GET",
    headers: {
      Authorization: "Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    },
  }
);

const data = await response.json();

$customerId = "9049402769586";
$query = http_build_query(["per_page" => 20]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.yukoapp.com/api/v1/public/customers/activities?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": "f7a8b9c0-d1e2-3456-fabc-d01234567890",
      "customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
      "activity_type": "purchase",
      "source_type": "loyalty_campaigns",
      "source_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "entry_type": "credit",
      "points": 100,
      "earning_type": "points",
      "metadata": {
        "earning_value": 100,
        "earning_type": "points",
        "entry_type": "credit"
      },
      "created_at": "2026-02-15T08:30:00.000Z"
    },
    {
      "id": "e6b7c8d9-e0f1-2345-efab-c01234567890",
      "customer_id": "63a2c89a-9936-4bc0-9d5f-93db46110b76",
      "activity_type": "point_adjustment",
      "source_type": "users",
      "source_id": null,
      "entry_type": "credit",
      "points": 50,
      "earning_type": "points",
      "metadata": {
        "description": "Bonus for completing a survey",
        "source": "rest_api"
      },
      "created_at": "2026-02-10T12:00:00.000Z"
    }
  ],
  "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"
  }
}

Redeem a reward List points transactions

Rest API

API References

Object Reference

Authorizations

Required Scope

Query Parameters

Query Parameters

Response

​Authorizations

​Required Scope

​Query Parameters

​Query Parameters

​Response

Authorizations

Required Scope

Query Parameters

Query Parameters

Response