award badge to user

Developing

POST

/badges/{id}/award

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/badges/b3df14ee-a674-480b-be2a-3f32c9d3a1d9/award' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "1"
}'

Response Example

{
    "meta": {
        "success": true,
        "message": "Badge has been rewarded successfully",
        "devMessage": "Badge has been rewarded successfully"
    },
    "body": [
        {
            "title": "Major",
            "action": "custom",
            "quantity": "3",
            "description": "One trade on a live account that makes 30%. Send account statement to #Tickmill-badge channel",
            "attachRequired": "true",
            "awarded": "true",
            "id": "{_id}",
            "image": "https://chartsnapshot.s3.amazonaws.com/apireturningai/tester/1721891103626-d763c952a89131696dd3bdf79fa0108.png"
        }
    ]
}

Modified at 2026-03-24 09:39:51

delete badge

remove badge from user