Claim collectible

Staging

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

POST

/collectible/claim

Collectible

Claims a collectible.

Request

Authorization

Add parameter in header

x-api-key

Example:

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

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

ClaimCollectibleBody

optional

One of

object

Example:

{"collectionId":"123e4567-e89b-12d3-a456-426655440000","userId":"123e4567-e89b-12d3-a456-426655440000"}

collectionId

string <uuid>

required

ID of the collectible to claim

userId

string <uuid>

required

ID of the user claiming the collectible

walletAddress

string

optional

Wallet address of the user claiming the collectible

Example

{
    "collectionId": "123e4567-e89b-12d3-a456-426655440000",
    "userId": "123e4567-e89b-12d3-a456-426655440000"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://testserver.loyi.io/public/api/collectible/claim' \
--header 'Origin;' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
    "collectionId": "123e4567-e89b-12d3-a456-426655440000",
    "userId": "123e4567-e89b-12d3-a456-426655440000"
}'

Responses

🟢201Created

application/json

Created

Body

object {0}

Example

{}

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

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

Get rewards

Get collectibles