---
title: "List points transactions"
method: GET
path: "/points_transactions"
tags: ["Points Transactions"]
---

# List points transactions

`GET /points_transactions`

Retrieves a list of points transactions.

## Query parameters

- `customer_id` integer — Filter results to only points transactions with the provided Smile customer ID.
- `updated_at_min` string, date-time — Filter results to only points transactions updated at or after the provided date and time.
- `limit` integer — The maximum number of points transactions to retrieve.
- `cursor` string — Cursor for the page of points transactions to retrieve.

## Response `200`

- object
  - `points_transactions` PointsTransaction[]
    - `id` integer — Unique identifier for the points transaction.
    - `customer_id` integer — The ID of the customer whose balance this points transaction applies to.
    - `points_change` integer — The number of points added or removed from the customer's points balance. The value is positive if points were added to the customer's balance and negative if points were deducted.
    - `description` string — A message visible to the customer that describes the reason for the points change.
    - `internal_note` string, nullable — A note that is visible to the merchant. This note should never be visible to customers.
    - `created_at` string, date-time — The date and time when the points transaction was created.
    - `updated_at` string, date-time — The date and time when the points transaction was last updated.
  - `metadata` PaginationMetadata
    - `next_cursor` string, nullable — A cursor value that when present, can be used to retrieve the next page of results.
    - `previous_cursor` string, nullable — A cursor value that when present, can be used to retrieve the previous page of results.

---

[API](https://skmtc.dev/smile/apis/smile-io-rest-api.md) · [All operations](https://skmtc.dev/smile/apis/smile-io-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smile/smile-io-rest-api/revisions/081bc804c5df/schema)