---
title: "Retrieve loyalty earn"
method: GET
path: "/api/v1.4/loyalty/earn/{id}/"
tags: ["v1.1"]
---

# Retrieve loyalty earn

`GET /api/v1.4/loyalty/earn/{id}/`

## Request

- Base URL: `https://web.moneyhash.io`
- URL: `https://web.moneyhash.io/api/v1.4/loyalty/earn/{id}/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in query parameter `access_token`

Returns the current state of a loyalty earn transaction belonging to the authenticated account.

## Path parameters

- `id` string, required

## Response `200`

- EarnDetail
  - `id` string, required: UUID is a unique identifier for the loyalty earn transaction.
  - `status` 'PENDING' | 'EARNED' | 'PENDING_REVERSE' | 'REVERSE_FAILED' | 'REVERSED' | 'FAILED': Lifecycle state: pending earn, earned, reversal, terminal failure, etc. * `PENDING` - PENDING * `EARNED` - EARNED * `PENDING_REVERSE` - PENDING_REVERSE * `REVERSE_FAILED` - REVERSE_FAILED * `REVERSED` - REVERSED * `FAILED` - FAILED
  - `provider` string, required: Display name of the loyalty provider.
  - `provider_id` string, required: MoneyHash loyalty service id (hashid)
  - `identifier` string, required: Customer identifier
  - `identifier_type` 'PHONE_NUMBER' | 'NATIONAL_ID' | 'EMAIL', required: How the identifier value should be interpreted (e.g. phone number). * `PHONE_NUMBER` - PHONE_NUMBER * `NATIONAL_ID` - NATIONAL_ID * `EMAIL` - EMAIL
  - `amount` string, decimal, required: Earn amount.
  - `currency` string, required: ISO currency code of the earn amount.
  - `merchant_reference` string, required: Merchant-supplied reference.
  - `provider_reference_id` string, nullable: Provider-side id returned by the earn call.
  - `reverse_provider_reference_id` string, nullable: Provider-side id returned by the reverse call.
  - `failure_reason` string, nullable, required
  - `reversed_at` string, date-time, nullable
  - `created` string, date-time, required
  - `modified` string, date-time, required

## Other responses

- `401`
- `404`

## Changes

- **2026-11-03** `4b67c1cef57d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/moneyhash/apis/moneyhash-api/changes/api/v1.4/loyalty/earn/:id/get.md)

---

[API](https://skmtc.dev/moneyhash/apis/moneyhash-api.md) - [All operations](https://skmtc.dev/moneyhash/apis/moneyhash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/moneyhash/apis/moneyhash-api/revisions/4b67c1cef57d?raw)