> For the complete documentation index, see [llms.txt](https://magicpay.gitbook.io/magicpay-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://magicpay.gitbook.io/magicpay-documentation/payments-and-wallet/reward-inquiry.md).

# Reward Inquiry

## 1.5 Reward Inquiry

Retrieves loyalty information.

**Request**

| Method | URL                                 |
| ------ | ----------------------------------- |
| POST   | /payment/v1/card-loyalties/retrieve |

```
{
    "cardToken": "cardtoken123",
    "posAlias": "pos1",
    "cardUserKey":"userkey123"
}

```

**Response**

| Status | Response                                                                                                                                                                                                                                                                                                       |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200    | <p>{</p><p>"data": {</p><p>"cardBrand": "VISA",</p><p>"force3ds": false,</p><p>"loyalties": \[</p><p>{</p><p>"type": "REWARD\_MONEY",</p><p>"message": "You earned $5 cashback.",</p><p>"reward": 5.0</p><p>}</p><p>],</p><p>"pos": {</p><p>"posInfo": "Your POS information here"</p><p>}</p><p>}</p><p>}</p> |
| 403    |                                                                                                                                                                                                                                                                                                                |
| 400    |                                                                                                                                                                                                                                                                                                                |
| 400    |                                                                                                                                                                                                                                                                                                                |
| 401    |                                                                                                                                                                                                                                                                                                                |
| 401    |                                                                                                                                                                                                                                                                                                                |
| 500    |                                                                                                                                                                                                                                                                                                                |

[<br>](https://hilals-organization.gitbook.io/magicpay-documentation/1.payments-and-wallet/1.4-query-payment)