---
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.

# List non-business days (deprecated)

**DEPRECATED**. Call the [Get non-business days](ref:get-non-business-days) endpoint instead.

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

Return a list of non-business days.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "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": {
    "parameters": {
      "AdminDivisionIDQuery": {
        "name": "administrativeDivisionId",
        "in": "query",
        "description": "Administrative Division ID filter",
        "required": true,
        "schema": {
          "type": "integer",
          "format": "int32"
        }
      },
      "BeginDateQuery": {
        "name": "beginDate",
        "in": "query",
        "description": "Get results on or after this date. \n\nThis field indicates what part of the year to start searching for holidays, not when the holiday was created at Pismo.\n\nFormat = yyyy-mm-dd. Must be less than or equal to `endDate`.\n",
        "schema": {
          "type": "string",
          "example": "2025-12-24"
        }
      },
      "CIDheader": {
        "name": "x-cid",
        "in": "header",
        "schema": {
          "type": "string"
        },
        "description": "The Correlation IDentifier UUID field links related API requests and events. The `x-cid` can help the Pismo engineering team track everything related to a call. If not passed, this field is automatically generated.\n"
      },
      "EndDateQuery": {
        "name": "endDate",
        "in": "query",
        "description": "Get holidays on or before this date. \n\nThis field indicates what part of the year to end searching for holidays, not when the holiday was created at Pismo.\n\nFormat: yyyy-mm-dd. Must be greater than or equal to `beginDate`.\"\n",
        "schema": {
          "type": "string",
          "example": "2025-11-02"
        }
      },
      "OrgHeader": {
        "name": "x-tenant",
        "in": "header",
        "description": "Organization/tenant ID",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    },
    "schemas": {
      "handler.HTTPError": {
        "description": "Error",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Error code"
          },
          "message": {
            "type": "string",
            "description": "Error message"
          }
        }
      },
      "IsHoliday": {
        "type": "boolean",
        "description": "Is this a holiday?",
        "example": true
      },
      "IsWeekend": {
        "type": "boolean",
        "description": "Is this a weekend day?",
        "example": true
      },
      "Metadata": {
        "type": "object",
        "description": "A valid JSON schema as specified in https://json-schema.org/specification.html. Used to register rules used to authorize the transaction.\n\n**Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata).\n"
      },
      "presenter.NonBusinessDay": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Non-business day date. Format = yyyy-mm-dd.",
            "example": "2023-01-20"
          },
          "is_holiday": {
            "$ref": "#/components/schemas/IsHoliday"
          },
          "is_weekend": {
            "$ref": "#/components/schemas/IsWeekend"
          },
          "holiday_metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "object"
            },
            "description": "A valid JSON schema as specified in https://json-schema.org/specification.html. Used to register rules used for transaction authorization.\n\n**Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata).\n"
          }
        }
      },
      "presenter.NonBusinessDaysResponse": {
        "type": "object",
        "properties": {
          "dates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/presenter.NonBusinessDay"
            }
          },
          "division_metadata": {
            "$ref": "#/components/schemas/Metadata"
          }
        }
      }
    },
    "responses": {
      "400BadRequestGetNonBusinessDay": {
        "description": "Bad request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            },
            "examples": {
              "missing-x-tenant-header": {
                "$ref": "#/components/examples/BadRequestResponseMissingHeader"
              },
              "missing-required-fields": {
                "$ref": "#/components/examples/BadRequestResponseMissingRequiredFields"
              },
              "invalid-date-format": {
                "$ref": "#/components/examples/BadRequestResponseHolidayWrongFormat"
              }
            }
          }
        }
      },
      "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"
        }
      },
      "NonBusinessDaysResponse": {
        "value": {
          "division_metadata": {
            "accrue_interest": true,
            "check_dormancy": true,
            "create_account": false,
            "defer_statement_due_date": true,
            "defer_transactions": true,
            "post_interest": false,
            "post_transactions": false,
            "run_cycle_closing": false
          },
          "holiday_metadata": {
            "accrue_interest": true,
            "check_dormancy": true,
            "create_account": false,
            "defer_statement_due_date": true,
            "defer_transactions": true,
            "post_interest": false,
            "post_transactions": false,
            "run_cycle_closing": false
          },
          "dates": [
            {
              "date": "2024-11-02",
              "is_holiday": true,
              "is_weekend": true
            },
            {
              "date": "2024-11-03",
              "is_holiday": false,
              "is_weekend": true
            },
            {
              "date": "2024-11-09",
              "is_holiday": false,
              "is_weekend": true
            }
          ]
        }
      }
    }
  },
  "paths": {
    "/holidays-core/v1/non-business-days": {
      "get": {
        "summary": "List non-business days (deprecated)",
        "description": "**DEPRECATED**. Call the [Get non-business days](https://developers.pismo.io/pismo-docs/reference/get-non-business-days) 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\nReturn a list of non-business days.\n",
        "operationId": "v1-get-non-business-days",
        "deprecated": true,
        "tags": [
          "Holidays (deprecated)"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/OrgHeader"
          },
          {
            "$ref": "#/components/parameters/CIDheader"
          },
          {
            "$ref": "#/components/parameters/AdminDivisionIDQuery"
          },
          {
            "$ref": "#/components/parameters/BeginDateQuery"
          },
          {
            "$ref": "#/components/parameters/EndDateQuery"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/presenter.NonBusinessDaysResponse"
                },
                "examples": {
                  "response-v1-non-business-days": {
                    "$ref": "#/components/examples/NonBusinessDaysResponse"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequestGetNonBusinessDay"
          },
          "401": {
            "$ref": "#/components/responses/401UnauthorizedError"
          },
          "404": {
            "$ref": "#/components/responses/404NotFoundCreateHolidayCalendar"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    }
  }
}
```