Get list of allocation(s) by user uid
Important:
Request headers are required. See API basics introduction for more information.
Get list of allocation(s) by users
Endpoint
GET /reward/allocate?user_uid={uid}
Returns the list of allocation details for a given user_uid associated with the given App (set by the X-API-KEY).
Parameters
Query parameters
| Query parameter | Description |
|---|---|
user_uid | The unique identifier of the user for this app (ex. 813231035224). |
Response
You will receive the list of allocation(s) details including the following fields:
| Response fields | Type | Description | Condition |
|---|---|---|---|
uid | String | The UID of the allocation. | Mandatory |
status | String | The status of the allocation (pending | done | failed). | Mandatory |
reward_uid | String | The UID of the reward associated. | Mandatory |
to_user_uid | String | The UID of the user to who the rewards are allocated. | Mandatory |
amount | String | The amount of rewards allocated | Mandatory |
nonce | String | The unique ID of the allocation that was given | Mandatory |
created_at | String (Timestamp) | The timestamp of the allocation creation. | Mandatory |
Response example
{
"success": true,
"data": [
{
"uid": "213134081289",
"status": "pending",
"reward_uid": "112144981245",
"to_user_uid": "223144788242",
"amount": "1.23",
"nonce": "nonce_1",
"created_at": "2023-08-10T14:07:14.494142Z"
},
...
]
}
Example
The following example fetches the allocations details for user 111111111111.
# API_KEY is your api key
# TOKEN is the access token generated with your api key secret
curl -i \
-X GET \
-H "Content-Type: application/json" \
-H "X-Api-Key: API_KEY" \
-H "Authorization: Bearer TOKEN" \
"https://api.getoriginal.com/v1/reward/allocation?user_uid=111111111111"
Updated about 2 months ago