> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yuko.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Points Transaction object

Points transactions are records of a customer’s points balance being changed. They can be positive (points added) or negative (points deducted), and act like a bank ledger or audit log.

[**​**](https://dev.smile.io/api/resources/points-transactions/points-transaction-object#schema-id)

**id**

**integer**

Unique identifier for the points transaction.

Example:

`825673452`

[**​**](https://dev.smile.io/api/resources/points-transactions/points-transaction-object#schema-customer-id)

**customer\_id**

**integer**

The ID of the customer whose balance this points transaction applies to.

Example:

`304169228`

[**​**](https://dev.smile.io/api/resources/points-transactions/points-transaction-object#schema-points-change)

**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.

Example:

`100`

[**​**](https://dev.smile.io/api/resources/points-transactions/points-transaction-object#schema-description)

**description**

**string**

A message visible to the customer that describes the reason for the points change.

Example:

`"Points correction"`

[**​**](https://dev.smile.io/api/resources/points-transactions/points-transaction-object#schema-internal-note-one-of-0)

**internal\_note**

**string | null**

A note that is visible to the merchant. This note should never be visible to customers.

Example:

`"Due to issue with order #6834"`

[**​**](https://dev.smile.io/api/resources/points-transactions/points-transaction-object#schema-created-at)

**created\_at**

**string\<date-time>**

The date and time when the points transaction was created.

Example:

`"2024-12-07T20:15:27.893Z"`

[**​**](https://dev.smile.io/api/resources/points-transactions/points-transaction-object#schema-updated-at)

**updated\_at**

**string\<date-time>**

The date and time when the points transaction was last updated.

Example:

`"2024-12-07T20:15:27.893Z"`