Last updated on September 9, 2026
How Do I Use the OpenAPI?
Our Open API add-on lets you pull your Vacation Tracker data into your own systems programmatically. You generate an API key from the dashboard, send it with each request, and read back your users, their leaves, locations, departments, leave types, and labels. It's a good fit when you want your own reporting, a data warehouse feed, or an internal tool that needs live leave data.
What You'll Need
How to Generate an API Key
- Log in to your Vacation Tracker account at app.vacationtracker.io/signin.
- Open Add-ons from the left menu.
- On the My Add-ons tab, find Open API and click View. If it isn't there, open the Discover More Add-ons tab, find Open API, and click Activate for free. It then moves to My Add-ons and you can open it with View.
- Scroll to the API Keys section.
- Type a name for the key in the API key name field.
- Click Create New API Key. The key appears in the table right away.
- Click the Copy icon next to the key to copy the full value, then paste it into your script or store it in your password manager.
Each key in the table shows three things: the name you gave it, its Current Month Usage against your monthly quota, and the API Key Secret. The secret stays masked, so only the first few characters are ever displayed. Use the Copy icon to get the full value whenever you need it, and the delete icon at the end of the row to revoke a key you no longer want in use.
Making Your First Request
The base URL is https://api.vacationtracker.io/v1. Every request needs your key in a header named x-api-key:
A successful call returns HTTP 200 and a body shaped like this:
If the key is missing or not recognized, you'll get HTTP 403 with {"message": "Forbidden"}. That's the most common thing to check first when a request fails.
What Data the API Gives You
These are the available endpoints, all read-only:
The /v1/users and /v1/leaves endpoints are paginated. If the response includes a nextToken, pass it back as a query parameter to fetch the next page, and use limit to control the page size.
Quotas and Rate Limits
Limits apply per API key:
The Current Month Usage column on the add-on page shows where each key stands, so you can check it before your usage becomes a problem. If your integration needs more than this, contact our Support team and tell us what you're building.
Common Questions
It depends on what you're doing. The API is for pulling data into your own code, on your own schedule, which suits reporting and data warehouse work. Zapier is the no-code option and works the other way around: Vacation Tracker sends leave events out and your Zap reacts to them. The MCP server connects an AI tool like Claude or ChatGPT so you can ask questions in plain language. Plenty of teams use more than one.
No. The Open API add-on is included on the Core and Complete plans.
You can create more than one, and we recommend a separate key per tool or service. Each key carries its own monthly usage counter, which also makes it easier to see which integration is doing the most calls.
Delete it from the API Keys table and create a new one. The old key stops working as soon as it's deleted, so update whatever was using it. You don't need to contact us to rotate a key, an Administrator can do it from the dashboard.
No. The Open API add-on is Administrators only, so only an Administrator can see it, generate keys, or revoke them. Keep in mind that a key isn't tied to one person's permissions the way a login is, which is another reason to share it carefully.
Book a Call