Award reward

Staging

https://testserver.loyi.io/public/api

POST

/reward/{id}/award

Reward

Awards a user with a reward.

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

string <uuid>

required

Reward ID

Header Params

Origin

string

required

The value must be one of the whitelisted domains. You can whitelist domain URLs on your Loyi dashboard.

Default:

<WHITELISTED_URL>

Example:

https://example.com

Body Params application/json

userId

string <uuid>

required

The user ID to award the reward.

tokenId

number

optional

The token ID. Required if reward is CouponLinkUnique.

Example

{
    "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
    "tokenId": 0
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://testserver.loyi.io/public/api/reward//award' \
--header 'Origin;' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
    "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
    "tokenId": 0
}'

Responses

🟢204No Content

No content

This response does not have a body.

🟠401Unauthorized

🟠404Record Not Found

Modified at 2025-06-19 21:23:41

Airdrop reward

Redeem rewards