Birthday.Gold
Log in

Partner API

Server-to-server JSON. Authenticate with your partner key (X-Partner-Key).

GET /api/business-details?brand=slug
Fetch your brand profile + reward config
GET /api/admin/pending-enrollment-count
Number of pending enrollments for your brand
POST /api/enroll
Notify us a user completed signup on your side
GET /api/celebrate?user=ID
Trigger a birthday reward event
Example response
{
  "status": "success",
  "data": { "brand": "Starbucks", "enrollments": 1240 }
}

Need a key? Create a business account.