---
title: "Check loyalty eligibility"
method: POST
path: "/api/v1.4/loyalty/eligibility/"
tags: ["v1.1"]
---

# Check loyalty eligibility

`POST /api/v1.4/loyalty/eligibility/`

## Request

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

Checks whether a customer identifier is eligible to earn loyalty points for the given loyalty provider. Some providers do not support this call; in that case the response returns eligible null with a reason.

## Request body

- CheckEligibilityRequest
  - `provider_id` string, required: MoneyHash loyalty service id (hashid) connected to the account.
  - `identifier` string, required: Customer identifier in the format required by identifier_type.
  - `identifier_type` 'PHONE_NUMBER' | 'NATIONAL_ID' | 'EMAIL', required: How to interpret identifier (for example PHONE_NUMBER, EMAIL, etc.). * `PHONE_NUMBER` - PHONE_NUMBER * `NATIONAL_ID` - NATIONAL_ID * `EMAIL` - EMAIL

## Response `200`

- CheckEligibilityResponse
  - `eligible` boolean, nullable, required: Whether the customer is eligible. Null when the provider does not expose an eligibility check.
  - `reason` string, nullable: Explanation when eligible is false or null.

## Other responses

- `400`
- `401`

## Changes

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

[Operation history](https://skmtc.dev/moneyhash/apis/moneyhash-api/changes/api/v1.4/loyalty/eligibility/post.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)