Skip to main content
Retrieves a paginated list of point transactions for a customer. Results are sorted by created_at in descending order. GET /public/customers/transactions

​
Authorizations

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

​
Required Scope

transactions:read This endpoint requires the transactions 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

entry_type enum<string> Filter results to only transactions of the given type. Available options: credit, debit 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 transaction. Example: "d4e5f6a7-b8c9-0123-defa-b01234567890" data.customer_id string<uuid> The UUID of the customer this transaction belongs to. Example: "63a2c89a-9936-4bc0-9d5f-93db46110b76" data.entry_type enum<string> Whether points were added or removed. Available options: credit, debit Example: "credit" data.points integer The number of points added or removed. Always a positive number — use entry_type to determine direction. Example: 100 data.action_type string The internal action that generated this transaction. Example: "purchase" data.status enum<string> The current status of the transaction. Available options: active, on_hold, used, failed Example: "active" data.description string | null A human-readable description of the transaction, if provided. Example: "Points for completing a purchase" data.source string | null The source that created this transaction. Example: "rest_api" data.transacted_at string<date-time> The date and time the transaction occurred. Example: "2026-02-15T08:30:00.000Z" data.created_at string<date-time> The date and time when the transaction record was created. Example: "2026-02-15T08:30:00.000Z" meta object Hide child attributes meta.pagination object Pagination details for the result set. Hide child attributes meta.pagination.current_page integer The current page number. Example: 1 meta.pagination.per_page integer The number of results per page. Example: 20 meta.pagination.total integer The total number of transactions. Example: 43 meta.pagination.last_page integer The last available page number. Example: 3 meta.pagination.has_more boolean Whether there are more pages to retrieve. Example: true 
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"

{
  "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.000Z",
      "created_at": "2026-02-15T08:30:00.000Z"
    },
    {
      "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.000Z",
      "created_at": "2024-06-01T10:00:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 2,
      "last_page": 1,
      "has_more": false
    }
  }
}