RadarPricesOrder

Home › APIs › Calculators & dates

Calculators & dates

Secret Santa Generator API

In plain words

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

FieldTypeDescription
namesarrayPeople, 3 to 500. A wish can follow after |, e.g. 'Ben | coffee'. A text with one name per line works too
excludearrayRules: 'Anna, Ben' = nobody in this group draws another one of them; 'Anna > Ben' = only Anna must not draw Ben
noMutualPairsbooleanNo pairs who give to each other (A to B and B to A)
privateLinksbooleanAdd a private reveal link and message for each person
eventstringName of the exchange, shown on the reveal page
budgetstringGift budget, e.g. 25 EUR
datestringGift 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.

Related APIs

Age Calculator APIShows exactly how old someone is in years, months and days, and when the next birthday is.
Business Days Calculator APICounts working days between dates, skipping weekends and the public holidays of your country.
Compound Interest Calculator APIShows how your savings grow over the years with interest and monthly deposits.
Date Calculator APICounts the days between two dates, or adds days, weeks or months to a date.
Loan Calculator APIShows your monthly loan payment, total interest and the full payment plan.
Percentage Calculator APIAnswers everyday percent questions, like 'what is 15% of 80' or 'how much did it go up'.