Vacation TrackerDeveloper Docs
REST API v2API referenceDepartments

List departments

This API method returns every department within the key's data reach, in one response without pagination. Requires departments:read. Admins see every department; other users see the departments they manage.

Each department has only its ID, name, default flag and creation time; the parent and approvers are returned by create and update.

GET
/v2/departments

Authorization

bearerAuth departments:read
AuthorizationBearer <token>

API key sent as Authorization: Bearer vt_live_<secret>. See the Authentication and Scopes sections at the top of this document for how keys are created, which scopes exist and how the key owner's role limits them.

In: header

Scope: departments:read

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/departments"
{
  "data": [
    {
      "id": "team-969f8429-7dc3-48a1-96b1-6049a99dda06",
      "name": "Operations",
      "isDefault": true,
      "createdAt": "2021-03-15T08:00:00.000Z"
    },
    {
      "id": "team-0a21c25e-6925-4a5b-90ee-ecf82096c4f6",
      "name": "Dev Team",
      "isDefault": false,
      "createdAt": "2022-08-22T15:00:00.000Z"
    }
  ]
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "name": "Unauthorized",
    "description": "The API key is missing, malformed or not recognized.",
    "resolution": "Send a valid API key in the Authorization header as Bearer followed by the full vt_live_ key.",
    "requestId": "c6af9ac6-7b61-11e6-9a41-93e8deadbeef"
  }
}

{
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "name": "InsufficientScope",
    "description": "The API key does not have the scopes this request needs.",
    "resolution": "Add the scopes listed in details.requiredScopes to the key in the Vacation Tracker dashboard.",
    "requestId": "c6af9ac6-7b61-11e6-9a41-93e8deadbeef",
    "details": {
      "requiredScopes": [
        "leaves:write"
      ]
    }
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "name": "RateLimited",
    "description": "Too many requests were sent in a short time.",
    "resolution": "Wait a few seconds and retry, using the same Idempotency-Key for writes.",
    "requestId": "c6af9ac6-7b61-11e6-9a41-93e8deadbeef"
  }
}
{
  "error": {
    "code": "INTERNAL_ERROR",
    "name": "InternalError",
    "description": "Something went wrong on our side.",
    "resolution": "Retry later, and if it keeps happening, contact Vacation Tracker support and quote the requestId.",
    "requestId": "c6af9ac6-7b61-11e6-9a41-93e8deadbeef"
  }
}

Need help?

developers@vacationtracker.io

Migrating from v1

Move an integration from REST API v1 to v2, with the differences in authentication, responses, errors and endpoints.

Create a department

This API method creates a department. Requires departments:write. The acting user is the key owner, or the X-On-Behalf-Of user. It waits for the department to be created and returns it, with its parent and approvers, with 201; if that takes longer than the wait window it returns 202 Accepted with an operation to poll.