---
title: "Claim community membership reward"
method: POST
path: "/v0.2.4/accounts/claim-reward"
tags: ["Account"]
---

# Claim community membership reward

`POST /v0.2.4/accounts/claim-reward`

## Request

- Base URL: `https://api.chimoney.io`
- URL: `https://api.chimoney.io/v0.2.4/accounts/claim-reward`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/chimoney/apis/chimoney-api-docs/docs/v0.2.4/accounts/claim-reward/post.ts> (a function with typed inputs; its response is checked against the schema)

Claims reward for community membership if eligible

## Request body

- object
  - `userID` string, required: The userID claiming the reward
  - `community` object, required
    - `communityID` string, required: Unique identifier for the community
    - `membershipID` string: Unique identifier for the membership
    - `voucherCode` string: Optional voucher code for the membership
    - `name` string: Name of the community
    - `memberName` string: Name of the member in the community
    - `communityType` 'free' | 'paid': Type of community membership
    - `expiryDate` string, date-time: Optional expiry date for the membership

## Response `200`

Reward claim processed successfully

- object
  - `status` 'success'
  - `message` string
  - `data` object: Additional data about the claim

## Other responses

- `400`: Invalid request parameters
- `401`: Access to this resource is not available for unauthenticated users.
- `403`: Access to this resource is forbidden.

---

[API](https://skmtc.dev/chimoney/apis/chimoney-api-docs.md) - [All operations](https://skmtc.dev/chimoney/apis/chimoney-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/chimoney/apis/chimoney-api-docs/revisions/227751df36a0?raw)