---
updatedAt: 2026-06-12T20:28:13.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.

# Get holiday (deprecated)

**DEPRECATED**. Call the [Get business day](ref:post-search-business-day) endpoint instead.

This endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.

Get information for an administrative division's holiday.

 **Note:** The response could contain outdated information until at least one minute after an update is made to an administrative division.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Platform setup - Holidays",
    "description": "Manage business and non-business days by organization",
    "version": "v1.0",
    "contact": {
      "name": "Pismo Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io/holidays-core",
      "description": "API sandbox server for testing"
    }
  ],
  "security": [
    {
      "S2SAuthentication": []
    }
  ],
  "tags": [
    {
      "name": "Holidays (deprecated)",
      "description": "View and manage business and non-business days configurations."
    }
  ],
  "components": {
    "schemas": {
      "CreatedAt": {
        "type": "string",
        "format": "datetime",
        "description": "Date and time the holiday was created. Format = yyyy-mm-ddTHH:mm:ss.",
        "example": "2024-04-30T17:24:03"
      },
      "handler.HTTPError": {
        "description": "Error",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Error code"
          },
          "message": {
            "type": "string",
            "description": "Error message"
          }
        }
      },
      "HolidayDate": {
        "type": "string",
        "description": "Holiday date. Format = yyyy-mm-dd.",
        "example": "2023-12-01"
      },
      "HolidayID": {
        "type": "integer",
        "description": "Holiday ID",
        "example": 8675309
      },
      "HolidayName": {
        "type": "string",
        "description": "Holiday name",
        "example": "New Year's Day",
        "maxLength": 80,
        "minLength": 1
      },
      "NextBusinessDate": {
        "type": "string",
        "format": "date",
        "description": "Next work day following the holiday. Format = yyyy-mm-dd.",
        "example": "2023-01-02"
      },
      "presenter.AdministrativeDivisionResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Administrative division ID",
            "example": 1111
          },
          "name": {
            "description": "Administrative division name",
            "type": "string",
            "example": "Brazil"
          }
        }
      },
      "presenter.HolidayResponse": {
        "type": "object",
        "properties": {
          "administrative_division": {
            "$ref": "#/components/schemas/presenter.AdministrativeDivisionResponse"
          },
          "id": {
            "$ref": "#/components/schemas/HolidayID"
          },
          "name": {
            "$ref": "#/components/schemas/HolidayName"
          },
          "holiday_date": {
            "$ref": "#/components/schemas/HolidayDate"
          },
          "next_business_date": {
            "$ref": "#/components/schemas/NextBusinessDate"
          },
          "created_at": {
            "$ref": "#/components/schemas/CreatedAt"
          }
        }
      },
      "presenter.ValidateHolidayRequest": {
        "type": "object",
        "required": [
          "date",
          "division_id"
        ],
        "properties": {
          "date": {
            "$ref": "#/components/schemas/HolidayDate"
          },
          "division_id": {
            "type": "integer",
            "description": "Division ID",
            "example": 100
          }
        }
      }
    },
    "responses": {
      "400BadRequestGetBusinessDay": {
        "description": "Bad request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            },
            "examples": {
              "missing-x-tenant-header": {
                "$ref": "#/components/examples/BadRequestResponseMissingHeader"
              },
              "missing-invalid-holiday-calendar-id": {
                "$ref": "#/components/examples/BadRequestResponseMissingRequiredFields"
              },
              "invalid-date-format": {
                "$ref": "#/components/examples/BadRequestResponseHolidayWrongFormat"
              },
              "missing-current-date": {
                "$ref": "#/components/examples/BadRequestResponseMissingRequiredFields"
              }
            }
          }
        }
      },
      "401UnauthorizedError": {
        "description": "Access token missing or invalid"
      },
      "404NotFoundCreateHolidayCalendar": {
        "description": "Not found",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            },
            "examples": {
              "holiday-calendar-not-found": {
                "$ref": "#/components/examples/BadRequestResponseHolidayCalendarNotFound"
              }
            }
          }
        }
      },
      "500InternalServerError": {
        "description": "Internal server error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            },
            "examples": {
              "generic-internal-error": {
                "$ref": "#/components/examples/InternalServerErrorResponse"
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "S2SAuthentication": {
        "type": "http",
        "scheme": "bearer",
        "description": "All requests must pass an [account-specific token](https://developers.pismo.io/pismo-docs/docs/account-specific-access-tokens).\n"
      }
    },
    "examples": {
      "InternalServerErrorResponse": {
        "value": {
          "code": "EHLD0001",
          "message": "Something went wrong - please try again"
        }
      },
      "BadRequestResponseMissingHeader": {
        "value": {
          "code": "EHLD0016",
          "message": "Missing x-tenant header"
        }
      },
      "BadRequestResponseHolidayWrongFormat": {
        "value": {
          "code": "EHLD0028",
          "message": "Holiday date with the wrong format"
        }
      },
      "BadRequestResponseMissingRequiredFields": {
        "value": {
          "code": "EHLD0050",
          "message": "Missing required fields"
        }
      },
      "BadRequestResponseHolidayCalendarNotFound": {
        "value": {
          "code": "EHLD0052",
          "message": "Holiday calendar not found"
        }
      }
    }
  },
  "paths": {
    "/holidays-core/v1/holiday/validate": {
      "post": {
        "summary": "Get holiday (deprecated)",
        "description": "**DEPRECATED**. Call the [Get business day](https://developers.pismo.io/pismo-docs/reference/post-search-business-day) endpoint instead.\n\nThis endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.\n\nGet information for an administrative division's holiday.\n\n **Note:** The response could contain outdated information until at least one minute after an update is made to an administrative division.\n",
        "operationId": "validate-v1-holiday",
        "deprecated": true,
        "tags": [
          "Holidays (deprecated)"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/presenter.ValidateHolidayRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/presenter.HolidayResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequestGetBusinessDay"
          },
          "401": {
            "$ref": "#/components/responses/401UnauthorizedError"
          },
          "404": {
            "$ref": "#/components/responses/404NotFoundCreateHolidayCalendar"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    }
  }
}
```