---
title: "List a contact's points history"
method: GET
path: "/loyalty/v2/contacts/{id}/points"
tags: ["Loyalty"]
---

# List a contact's points history

`GET /loyalty/v2/contacts/{id}/points`

## Request

- Base URL: `https://api.splio.com`
- URL: `https://api.splio.com/loyalty/v2/contacts/{id}/points`
- Auth: HTTP bearer

Get the list of a contact's points history. This endpoint will be deprecated end of 2022. Please use this new one instead: https://developer.splio.com/#get_loyalty_points

## Path parameters

- `id` string, required

## Query parameters

- `per_page` integer
- `page_number` integer
- `fields` object[]
  - `key` 'card_code' | 'operation_date' | 'points_type' | 'points_credited' | 'points_earned' | 'validity_end' | 'id_program' | 'program_name' | 'id_tier' | 'tier_name' | 'status': search fields, in rewards
  - `operator` 'is' | 'after' | 'before' | 'contains' | 'ends' | 'equal' | 'greater' | 'isnot' | 'lower' | 'notequal' | 'starts': operator for search operators are limited by the type of value expected
  - `value` string

## Response `200`

Points retrieval is successful.

## Other responses

- `400`: The request validation failed.
- `401`: Authentication failed.
- `403`: Forbidden.
- `404`: Contact not found.

## Changes

- **2026-11-03** `563a91bd331b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/splio/apis/splio-customer-platform/changes/loyalty/v2/contacts/:id/points/get.md)

---

[API](https://skmtc.dev/splio/apis/splio-customer-platform.md) - [All operations](https://skmtc.dev/splio/apis/splio-customer-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/splio/apis/splio-customer-platform/revisions/563a91bd331b?raw)