Birthday Endpoint
Documentation for the /api/jkt48/birthday endpoint to track JKT48 member birthdays.
GET /api/jkt48/birthday
This endpoint provides birthday information for JKT48 members, including a list of members with upcoming birthdays.
Request
GET https://v2.jkt48connect.com/api/jkt48/birthday?apikey=YOUR_API_KEY| Parameter | Type | Required | Description |
|---|---|---|---|
apikey | string | ✅ | API key for authentication |
Example Request
curl "https://v2.jkt48connect.com/api/jkt48/birthday?apikey=YOUR_API_KEY"Example Response
[
{
"name": "Zee",
"date": "2004-05-16",
"generation": "JKT48 Gen 7",
"is_today": false,
"days_until": 40
},
{
"name": "Muthe",
"date": "2004-07-12",
"generation": "JKT48 Gen 7",
"is_today": false,
"days_until": 97
}
]Response Structure
| Field | Type | Description |
|---|---|---|
name | string | Member's name |
date | string | Birth date (YYYY-MM-DD) |
generation | string | Member's generation |
is_today | boolean | true if today is their birthday |
days_until | number | Number of days until their next birthday |
Usage Example (JavaScript)
const API_KEY = 'YOUR_API_KEY';
async function getBirthdays() {
const response = await fetch(
`https://v2.jkt48connect.com/api/jkt48/birthday?apikey=${API_KEY}`
);
const birthdays = await response.json();
const today = birthdays.filter(m => m.is_today);
const upcoming = birthdays
.filter(m => m.days_until > 0 && m.days_until <= 30)
.sort((a, b) => a.days_until - b.days_until);
if (today.length > 0) {
console.log('🎉 Celebrating Today:');
today.forEach(m => console.log(` 🎂 ${m.name} (${m.generation})`));
}
console.log('\n📅 Birthdays This Month:');
upcoming.forEach(m => {
console.log(` 🎁 ${m.name} — in ${m.days_until} days`);
});
}
getBirthdays();