What's in tonight's show?
Comprehensive data for any individual JKT48 theater show — full member lineup, setlist details, seitansai celebrations, and ticket information. Everything you need to build rich show detail pages.
- Full member lineup
- Setlist details
- Seitansai info
- Ticket status
What is the Theater Detail API?
The Theater Detail API provides comprehensive information about a single JKT48 theater show, identified by its show_id from the Theater Schedule API.
Where the Theater API gives you a list of shows with summary data, Theater Detail goes deeper — giving you everything there is to know about one specific performance.
The Theater Detail response includes:
- Full member lineup — the complete list of all members performing in the show, not just senbatsu starters
- Setlist details — the show title, setlist name, and show description
- Seitansai (birthday celebration) — if the show features a member's birthday celebration, the honored member and celebration details are included
- Show type — regular show, birthday show (seitansai), special show, request hour, or unit show
- Date & time — exact show time, door opening time, and show start time
- Ticket information — ticket status, lottery details, and ticket purchase links where available
- Venue details — theater name, floor, and location
- MC and special segments — additional show segments or special announcements where available
This endpoint is the foundation for building comprehensive show detail pages, seitansai trackers, and any feature that needs complete per-show data rather than the summary provided by the Theater list endpoint.
What you can do with Theater Detail
Build rich show detail pages, seitansai trackers, and member lineup features with per-show granular data.
Full member lineup
Access the complete list of all members performing in the show — beyond the senbatsu starters. See every member on stage for that specific performance.
Seitansai (birthday celebration) data
When a show features a member's seitansai, the Theater Detail response includes the honored member, celebration type, and any special birthday show details.
Setlist & show description
Get the full setlist name, show title, and description — the complete identity of the performance beyond just the team and date.
Ticket status & purchase links
Access current ticket availability, lottery status, and direct purchase links where officially available — ready to display to fans visiting a show detail page.
Show timing details
Access door opening time and show start time alongside the date — all the information fans need to plan their attendance.
Linked via show_id
Uses the show_id field from the Theater API response as the lookup key — making it easy to enrich any theater schedule entry with full show detail on demand.
How the Theater Detail endpoint works
Two steps: get the show_id from the Theater API, then fetch the full detail.
Get a show_id from the Theater API
Call GET /v1/theater to get the upcoming show schedule. Each show entry includes a show_id that uniquely identifies that performance.
Call the Theater Detail endpoint
Make a GET request to /v1/theater/:show_id with your API key and the show_id from step one. The response returns comprehensive detail for that specific show.
Display the full show page
Use the member lineup, setlist info, seitansai data, and ticket details to build a complete show detail page — everything fans need to know about a specific performance.
Who uses Theater Detail
Fan developers building show detail pages and theater-focused tracking features.
Show detail pages
Build comprehensive show detail pages that display the full member lineup, setlist name, seitansai info, show timing, and ticket status — giving fans everything they need to decide whether to attend or follow along.
Seitansai trackers
Build dedicated seitansai tracking features that highlight upcoming birthday shows, the honored member, and celebration details. Let fans plan ahead for their oshi's seitansai.
Member appearance detail
Use Theater Detail to show fans not just which shows a member appeared in, but the full context — the complete lineup, the setlist, and whether it was a special show type.
Ticket availability pages
Build show pages with live ticket status and direct purchase links — combining Theater Detail with periodic polling or webhooks to keep availability status current.
Related features
Explore more capabilities that work together with this feature.
Theater Schedule
Start here to get show_id values from the upcoming schedule. Theater Detail enriches any show entry from this endpoint.
Members
Theater Detail member lineup entries reference member records. Use the Members API to enrich each lineup entry with photos, generation info, and social links.
Member Detail
Member Detail includes upcoming theater appearances. Combine with Theater Detail for the most complete show and member data.
Events
Special theater events like seitansai and request hour shows also appear in the Events API for a different view of the same data.
Frequently asked questions
Common questions about the Theater Detail API.
Ready to get started?
Integrate JKT48 data in minutes. Free tier available, no credit card required.
Explore the Theater Detail API