Home › APIs › Calculators & dates
Secret Santa Generator API
Draws Secret Santa names for a group so nobody gets themselves, couples can be kept apart, and each person gets a private link with only their match.
Used by: Small businesses, HR and payroll, finance apps and everyday users.
Draw names for a gift exchange in one call: everyone gives exactly one gift and gets one, never themselves. Rules: couples or families who must not draw each other, one-way rules (last year's pairs), and no two people who simply swap gifts (default). Optional wish per person, budget and gift day. Returns every pair and, for each person, a private link that shows only their match plus a ready message to send. The draw is cryptographically random and nothing is stored: it lives encrypted inside the links. Up to 500 people. For HR tools, party apps, chat bots and class or club websites.
Try it live, no sign-up
Run the example as is, or change the input. 5 own tries a day without a key.
Example request
curl -X POST https://radarbg.com/v1/secret-santa-generator \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"names": ["Anna | books", "Ben", "Chloe", "David", "Emma"], "exclude": ["Anna, Ben"], "budget": "25 EUR", "date": "2026-12-19", "event": "Office Secret Santa"}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
names | array | People, 3 to 500. A wish can follow after |, e.g. 'Ben | coffee'. A text with one name per line works too |
exclude | array | Rules: 'Anna, Ben' = nobody in this group draws another one of them; 'Anna > Ben' = only Anna must not draw Ben |
noMutualPairs | boolean | No pairs who give to each other (A to B and B to A) |
privateLinks | boolean | Add a private reveal link and message for each person |
event | string | Name of the exchange, shown on the reveal page |
budget | string | Gift budget, e.g. 25 EUR |
date | string | Gift day, e.g. 2026-12-19 (links stop 45 days later) |
Price
Included in every plan: 500 calls a month free, then from €9 a month for 5,000 calls across all APIs. Pro, €29 for 25,000 calls, is the one we recommend.
Questions
What does the Secret Santa Generator API do?
Draws Secret Santa names for a group so nobody gets themselves, couples can be kept apart, and each person gets a private link with only their match.
Where does the data come from?
Draw names for a gift exchange in one call: everyone gives exactly one gift and gets one, never themselves. Rules: couples or families who must not draw each other, one-way rules (last year's pairs), and no two people who simply swap gifts (default). Optional wish per person, budget and gift day. Returns every pair and, for each person, a private link that shows only their match plus a ready messa
How much does it cost?
500 calls a month are free with no card. Paid plans start at EUR 9 a month for 5,000 calls and include every API on Radar. Failed calls are not counted.
Can I use it without writing code?
Yes. Try it live on this page, use our free browser tools, or ask us to run it on your list as a service.