How to retrieve vacation data from Big Picture plugin in Jira

I need help extracting vacation and time-off information from the Big Picture plugin in our Jira system using their REST API. I’ve been trying different endpoint URLs but nothing seems to work properly.

Our setup details:

  • Big Picture plugin version 8.47.0
  • Jira Server (on-premises installation)
  • Looking to get time-off data for team members

I would prefer to fetch vacation data for our entire team in a single API request, but individual calls for each team member would work too. Does anyone have working examples or know the correct API endpoints to use? Any documentation links would be really helpful.

Basically I want to programmatically access the same vacation information that shows up in the Big Picture interface when viewing team schedules and availability.

Big Picture REST API endpoints are tricky, especially for vacation data. I’ve worked with version 8.x and you’ll want /rest/com.softwareplant.bigpicture/1.0/timeoff or something similar. The exact endpoint depends on your Big Picture setup and enabled modules though. Here’s what worked for me: open the browser console while accessing the vacation calendar manually in Big Picture. You’ll see the actual API calls with full request headers and parameters. Some installations need specific auth tokens beyond your regular Jira credentials too. If you’re still stuck, contact SoftwarePlant through their support portal. They’ll give you endpoint docs specific to your plugin version - this stuff isn’t always public. The response format usually has user IDs, date ranges, and vacation types in JSON.

I encountered similar problems while working with the Big Picture plugin. The documentation for their REST API can be a bit sparse. Generally, you’ll find the vacation data endpoints located under /rest/com.softwareplant.bigpicture/1.0/, but keep in mind that the exact paths may vary based on the version you’re using. A useful approach is to enable debug logging in Jira, then check the network requests in your browser’s developer tools while navigating to the vacation data in Big Picture’s web interface. This can help you identify the exact API calls made. Additionally, make sure to verify your Big Picture permissions, as some endpoints may return no data if access is restricted. It might also be worth reaching out to SoftwarePlant support; they’ve assisted me previously in pinpointing the correct endpoints for my plugin version.

Check the /rest/com.softwareplant.bigpicture/1.0/resource/timeoff endpoint - that’s what worked on my 8.4x setup. You’ll probably need query params like ?teamId=xxx or ?startDate=yyyy-mm-dd depending on what you’re pulling. And make sure your user has Big Picture permissions or you’ll just get empty responses with no error message.