Holidays API

List holidays

List all holidays for an account:

GET /holidays

Response

Status: 200 OK
[
  {
    "picture_uri": null,
    "name": "2016 Company BBQ",
    "created_at": "2016-03-14T03:09:42-06:00",
    "sourceID": null,
    "updated_at": "2016-03-14T03:09:42-06:00",
    "end_at": "2016-06-18T00:00:00",
    "start_at": "2016-06-17T16:00:00",
    "id": 4,
    "source": null
  },
  {
    "picture_uri": null,
    "name": "Christmas 2010",
    "created_at": "2016-03-14T03:09:42-06:00",
    "sourceID": null,
    "updated_at": "2016-03-14T03:09:42-06:00",
    "end_at": "2010-12-26T00:00:00",
    "start_at": "2010-12-25T00:00:00",
    "id": 2,
    "source": null
  },
  "..."
]

The response contains these fields by default. Filtering and pagination are available to reduce/limit the collection of holidays.

Collection Fields

By default the following fields will appear in collections of holidays:

id source sourceID name picture_uri start_at end_at created_at updated_at

Obtain a different set of fields using the ?fields= parameter.

Filtering

Filtering is available for the following fields:

id sourceID name start_at end_at created_at updated_at

The filters on sourceID, and name are not case sensitive.

Sorting

By default a collection of holidays is sorted ascending by name.

The following fields are accepted by the ?sort= parameter:

id sourceID name created_at updated_at

Get a single holiday

GET /holidays/:id

Response

Status: 200 OK
{
  "picture_uri": null,
  "name": "2016 Company BBQ",
  "created_at": "2016-03-14T03:09:42-06:00",
  "sourceID": null,
  "updated_at": "2016-03-14T03:09:42-06:00",
  "end_at": "2016-06-18T00:00:00",
  "start_at": "2016-06-17T16:00:00",
  "id": 4,
  "source": null
}

The response contains these fields.

Create a holiday

POST /holidays

When creating a new holiday these fields are available.

Response

Status: 201 Created
{
  "created_at": "...",
  "...": "..."
}

The response contains all fields of the created holiday and is similar to the response in Get a single holiday

Update a holiday

PATCH /holidays/:id

When updating a holiday these fields are available.

Response

Status: 200 OK
{
  "created_at": "...",
  "...": "..."
}

The response contains all fields of the updated holiday and is similar to the response in Get a single holiday

Fields

created_at
Readonly datetime — The date and time at which the holiday was created.
end_at
Required datetime
id
Readonly integer — The unique ID of the holiday.
name
Required string (max 80) — The Name field is used to enter the name of the holiday.
picture_uri
Optional string — The hyperlink to the image file for the holiday.
source
Optional string (max 30) - See source
sourceID
Optional string (max 128) - See source
start_at
Required datetime
updated_at
Readonly datetime — The date and time of the last update of the holiday. If the holiday has no updates it contains the created_at value.