---
updatedAt: 2026-04-30T17:53:32.000Z
---
Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further.
# List holidays (deprecated)
**DEPRECATED**. Call the new [List holidays](https://developers.pismo.io/pismo-docs/reference/get-holiday-new) endpoint instead.
Retrieve a paginated list of holidays.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "Platform setup - Organizations",
"description": "View and manage organizations.
Note: An updated version of the Holidays API is available.",
"version": "v1.0",
"contact": {
"name": "Pismo Support",
"url": "https://developers.pismo.io/support/"
},
"license": {
"name": "Copyright Pismo"
}
},
"servers": [
{
"url": "https://sandbox.pismolabs.io",
"description": "Sandbox API server for testing."
}
],
"tags": [
{
"name": "Holidays (deprecated)",
"description": "View and manage some general holidays configurations"
}
],
"components": {
"parameters": {
"HolidayNameQuery": {
"name": "name",
"in": "query",
"description": "Holiday name filter",
"schema": {
"type": "string",
"maxLength": 255,
"example": "Christmas"
}
},
"HolidayYearQuery": {
"name": "holidayYear",
"in": "query",
"description": "Holiday year filter",
"schema": {
"type": "string",
"example": "2024"
}
},
"HolidayDateQuery": {
"name": "holidayDate",
"in": "query",
"description": "Holiday date filter. Format = yyyy-mm-dd.",
"schema": {
"type": "string",
"example": "2024-02-24"
}
},
"OrderQuery": {
"name": "order",
"in": "query",
"description": "Sort order. Default = `ASC`.",
"schema": {
"type": "string",
"enum": [
"ASC",
"DESC"
],
"example": "DESC"
}
},
"OrderByQuery": {
"name": "orderBy",
"in": "query",
"description": "Sort order. Default = `ID`.",
"schema": {
"type": "string",
"enum": [
"ID",
"name",
"holidayYear",
"holidayDate"
],
"example": "name"
}
},
"PageQuery": {
"name": "page",
"in": "query",
"description": "Current page. Must be greater than 0. Default is `1`.",
"schema": {
"type": "integer",
"format": "int32",
"example": 2
}
},
"PerPageQuery": {
"name": "perPage",
"in": "query",
"description": "Maximum number of items per page. Must be greater than 0. Default is `10`.",
"schema": {
"type": "integer",
"format": "int32",
"example": 20
}
},
"TenantIdHeader": {
"name": "x-tenant",
"in": "header",
"description": "Pismo organization ID",
"required": true,
"style": "simple",
"schema": {
"type": "string",
"example": "TN-cc8f8b89-233a-4582-9f36-63ee85278d6d"
}
}
},
"schemas": {
"CurrentPage": {
"type": "integer",
"description": "Current page",
"format": "int32",
"default": 1,
"example": 1
},
"HolidayDate": {
"type": "string",
"description": "Holiday date. Format = yyyy-mm-dd.",
"example": "2024-02-24"
},
"HolidayDetails": {
"description": "Holiday details",
"type": "object",
"properties": {
"holiday_date": {
"$ref": "#/components/schemas/HolidayDate"
},
"id": {
"$ref": "#/components/schemas/HolidayID"
},
"name": {
"$ref": "#/components/schemas/HolidayName"
},
"working_date": {
"$ref": "#/components/schemas/WorkingDate"
}
}
},
"HolidayID": {
"example": 1,
"description": "Holiday ID",
"type": "integer",
"format": "int64"
},
"HolidayName": {
"type": "string",
"description": "Holiday name",
"example": "Festivus"
},
"HolidaysPageResponse": {
"type": "object",
"properties": {
"current_page": {
"$ref": "#/components/schemas/CurrentPage"
},
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/HolidayDetails"
}
},
"pages": {
"$ref": "#/components/schemas/Pages"
},
"per_page": {
"$ref": "#/components/schemas/PerPage"
},
"total_items": {
"$ref": "#/components/schemas/TotalItems"
}
}
},
"HTTPError": {
"description": "Error",
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Error code"
},
"message": {
"type": "string"
}
}
},
"Pages": {
"default": 1,
"description": "Total number of pages",
"example": 2,
"type": "integer",
"format": "int32"
},
"PerPage": {
"default": 10,
"description": "Maximum number of items per page",
"example": 10,
"type": "integer",
"format": "int32"
},
"TotalItems": {
"description": "Total number of items",
"example": 21,
"type": "integer",
"format": "int32"
},
"WorkingDate": {
"description": "Working date. The first normal business day after the holiday. Format = yyyy-mm-dd.",
"example": "2023-02-22",
"type": "string"
}
},
"responses": {
"401UnauthorizedError": {
"description": "Unauthorized"
},
"404NotFound": {
"description": "Not Found"
}
},
"examples": {
"BadRequestResponse": {
"value": {
"code": "EOA0030",
"message": "Missing x-tenant header"
}
},
"GetV1HolidaysResponse": {
"value": {
"pages": 1,
"current_page": 1,
"per_page": 10,
"total_items": 4,
"items": [
{
"id": 1,
"name": "Carnival",
"holiday_date": "2023-02-20",
"working_date": "2023-02-22"
},
{
"id": 2,
"name": "Corpus Christi",
"holiday_date": "2023-05-01",
"working_date": "2023-05-02"
},
{
"id": 3,
"name": "Independence Day",
"holiday_date": "2023-09-07",
"working_date": "2023-09-08"
},
{
"id": 4,
"holiday_date": "2023-11-02",
"working_date": "2023-11-03"
}
]
}
},
"InternalServerErrorResponse": {
"value": {
"code": "EOA0001",
"message": "Something went wrong, please try again later"
}
},
"TenantNotFoundResponse": {
"value": {
"code": "EOA0100",
"message": "Org TN-00000000000001 was not found"
}
}
},
"securitySchemes": {
"S2SAuthentication": {
"type": "http",
"scheme": "bearer",
"description": "All requests must be previously authenticated with an account-specific token.",
"bearerFormat": "JWT"
}
}
},
"security": [
{
"S2SAuthentication": []
}
],
"paths": {
"/orgs-core/v1/orgs/holidays": {
"get": {
"summary": "List holidays (deprecated)",
"description": "**DEPRECATED**. Call the new [List holidays](https://developers.pismo.io/pismo-docs/reference/get-holiday-new) endpoint instead.\n\nRetrieve a paginated list of holidays.\n",
"deprecated": true,
"operationId": "get-v1-orgs-holidays",
"tags": [
"Holidays (deprecated)"
],
"parameters": [
{
"$ref": "#/components/parameters/TenantIdHeader"
},
{
"$ref": "#/components/parameters/PageQuery"
},
{
"$ref": "#/components/parameters/PerPageQuery"
},
{
"$ref": "#/components/parameters/OrderQuery"
},
{
"$ref": "#/components/parameters/OrderByQuery"
},
{
"$ref": "#/components/parameters/HolidayNameQuery"
},
{
"$ref": "#/components/parameters/HolidayYearQuery"
},
{
"$ref": "#/components/parameters/HolidayDateQuery"
}
],
"responses": {
"200": {
"description": "Holidays page",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HolidaysPageResponse"
},
"examples": {
"response-v1-orgs": {
"$ref": "#/components/examples/GetV1HolidaysResponse"
}
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPError"
},
"examples": {
"missing-x-tenant-header": {
"$ref": "#/components/examples/BadRequestResponse"
},
"tenant-not-found": {
"$ref": "#/components/examples/TenantNotFoundResponse"
}
}
}
}
},
"401": {
"$ref": "#/components/responses/401UnauthorizedError"
},
"404": {
"$ref": "#/components/responses/404NotFound"
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPError"
},
"examples": {
"generic-internal-error": {
"$ref": "#/components/examples/InternalServerErrorResponse"
}
}
}
}
}
}
}
}
}
}
```