> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fincept.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Is Business Day

> Check if a date is a business day according to a specific calendar. Returns whether the date is a business day, weekend, or holiday. Useful for validating payment dates, settlement dates, and trade dates in financial calculations. [Tier: FREE, Credits: 0]



## OpenAPI

````yaml api-specs/scheduling.json post /quantlib/scheduling/calendar/is-business-day
openapi: 3.1.0
info:
  title: FinceptQuantLib API - Scheduling
  description: Scheduling module endpoints for FinceptQuantLib API
  version: 3.0.0
  contact:
    name: Fincept API Support
    url: https://fincept.in
servers:
  - url: https://api.fincept.in
    description: Fincept API Production Server
security:
  - APIKeyHeader: []
tags:
  - name: quantlib-scheduling
    description: API endpoints for scheduling operations
paths:
  /quantlib/scheduling/calendar/is-business-day:
    post:
      tags:
        - quantlib-scheduling
      summary: Is Business Day
      description: >-
        Check if a date is a business day according to a specific calendar.
        Returns whether the date is a business day, weekend, or holiday. Useful
        for validating payment dates, settlement dates, and trade dates in
        financial calculations. [Tier: FREE, Credits: 0]
      operationId: is_business_day_quantlib_scheduling_calendar_is_business_day_post
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - date
              properties:
                date:
                  type: string
                  format: date
                  description: Date to check in ISO format (YYYY-MM-DD)
                  example: '2024-07-04'
                calendar:
                  type: string
                  description: >-
                    Calendar to use for business day determination. Options: US,
                    UK, TARGET, Japan, Weekend
                  default: US
                  enum:
                    - US
                    - UK
                    - TARGET
                    - Japan
                    - Weekend
                  example: US
            example:
              date: '2024-07-04'
              calendar: US
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      date:
                        type: string
                        format: date
                        description: The input date
                        example: '2024-07-04'
                      calendar:
                        type: string
                        description: The calendar used
                        example: US
                      is_business_day:
                        type: boolean
                        description: True if the date is a business day
                        example: false
                      is_weekend:
                        type: boolean
                        description: True if the date is a weekend
                        example: false
                      is_holiday:
                        type: boolean
                        description: True if the date is a holiday
                        example: true
              example:
                success: true
                data:
                  date: '2024-07-04'
                  calendar: US
                  is_business_day: false
                  is_weekend: false
                  is_holiday: true
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '402':
          $ref: '#/components/responses/InsufficientTierError'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
                    items:
                      type: object
                      properties:
                        loc:
                          type: array
                          items:
                            type: string
                        msg:
                          type: string
                        type:
                          type: string
              example:
                detail:
                  - loc:
                      - body
                      - date
                    msg: field required
                    type: value_error.missing
      security:
        - APIKeyHeader: []
components:
  responses:
    UnauthorizedError:
      description: Authentication information is missing or invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              detail:
                type: string
                example: Invalid API key
    InsufficientTierError:
      description: API tier insufficient for this endpoint
      content:
        application/json:
          schema:
            type: object
            properties:
              detail:
                type: string
                example: Endpoint requires Basic tier or higher
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key for authentication. Get your key at
        https://api.fincept.in/auth/register

````