API ReferenceRewards
Send rewards in bulk
Sends up to 500 rewards in one request. Returns 207 with a per-item result; processing stops early if your wallet runs out of funds and remaining items are marked skipped.
Authorization
apiKey AuthorizationBearer <token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/rewards/bulk" \ -H "Content-Type: application/json" \ -d '{ "rewards": [ { "type": "FIXED", "valueCents": 1, "recipient": { "email": "user@example.com", "firstName": "string" } } ] }'{ "sent": 0, "failed": 0, "results": [ { "index": 0, "ok": true, "rewardId": "string", "error": "string" } ]}