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

# Generate Schedule

> Generate a complete payment or accrual schedule for financial instruments such as bonds, swaps, and loans. Creates a series of periods with start dates, end dates, and payment dates, automatically adjusting for business days and holidays. Supports various frequencies, stub periods, and rolling conventions. [Tier: FREE, Credits: 0]



## OpenAPI

````yaml api-specs/scheduling.json post /quantlib/scheduling/schedule/generate
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/schedule/generate:
    post:
      tags:
        - quantlib-scheduling
      summary: Generate Schedule
      description: >-
        Generate a complete payment or accrual schedule for financial
        instruments such as bonds, swaps, and loans. Creates a series of periods
        with start dates, end dates, and payment dates, automatically adjusting
        for business days and holidays. Supports various frequencies, stub
        periods, and rolling conventions. [Tier: FREE, Credits: 0]
      operationId: generate_schedule_quantlib_scheduling_schedule_generate_post
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - effective_date
                - termination_date
              properties:
                effective_date:
                  type: string
                  format: date
                  description: >-
                    Start date of the schedule (issue date) in ISO format
                    (YYYY-MM-DD)
                  example: '2024-01-15'
                termination_date:
                  type: string
                  format: date
                  description: >-
                    End date of the schedule (maturity date) in ISO format
                    (YYYY-MM-DD)
                  example: '2026-01-15'
                frequency:
                  type: string
                  description: >-
                    Payment frequency. Determines how often coupon/interest
                    payments occur
                  default: Semi-Annual
                  enum:
                    - Annual
                    - Semi-Annual
                    - Quarterly
                    - Monthly
                  example: Semi-Annual
                calendar:
                  type: string
                  description: Calendar for business day adjustments
                  default: Weekend
                  enum:
                    - US
                    - UK
                    - TARGET
                    - Japan
                    - Weekend
                  example: Weekend
                adjustment:
                  type: string
                  description: Business day adjustment convention for payment dates
                  default: Modified Following
                  enum:
                    - Following
                    - Modified Following
                    - Preceding
                    - Modified Preceding
                    - Unadjusted
                  example: Modified Following
                stub:
                  type: string
                  description: Stub period convention if the schedule doesn't divide evenly
                  default: Short Front
                  enum:
                    - Short Front
                    - Short Back
                    - Long Front
                    - Long Back
                  example: Short Front
            example:
              effective_date: '2024-01-15'
              termination_date: '2026-01-15'
              frequency: Semi-Annual
              calendar: Weekend
              adjustment: Modified Following
              stub: Short Front
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      effective_date:
                        type: string
                        format: date
                        description: The schedule start date
                        example: '2024-01-15'
                      termination_date:
                        type: string
                        format: date
                        description: The schedule end date
                        example: '2026-01-15'
                      frequency:
                        type: string
                        description: Payment frequency used
                        example: Semi-Annual
                      total_periods:
                        type: integer
                        description: Total number of coupon/payment periods
                        example: 4
                      periods:
                        type: array
                        items:
                          type: object
                          properties:
                            start_date:
                              type: string
                              format: date
                              description: Period start date (accrual start)
                            end_date:
                              type: string
                              format: date
                              description: Period end date (accrual end)
                            payment_date:
                              type: string
                              format: date
                              description: Payment date (adjusted for business days)
                        description: Array of schedule periods with dates
                        example:
                          - start_date: '2024-01-15'
                            end_date: '2024-07-15'
                            payment_date: '2024-07-15'
                          - start_date: '2024-07-15'
                            end_date: '2025-01-15'
                            payment_date: '2025-01-15'
                          - start_date: '2025-01-15'
                            end_date: '2025-07-15'
                            payment_date: '2025-07-15'
                          - start_date: '2025-07-15'
                            end_date: '2026-01-15'
                            payment_date: '2026-01-15'
              example:
                success: true
                data:
                  effective_date: '2024-01-15'
                  termination_date: '2026-01-15'
                  frequency: Semi-Annual
                  total_periods: 4
                  periods:
                    - start_date: '2024-01-15'
                      end_date: '2024-07-15'
                      payment_date: '2024-07-15'
                    - start_date: '2024-07-15'
                      end_date: '2025-01-15'
                      payment_date: '2025-01-15'
                    - start_date: '2025-01-15'
                      end_date: '2025-07-15'
                      payment_date: '2025-07-15'
                    - start_date: '2025-07-15'
                      end_date: '2026-01-15'
                      payment_date: '2026-01-15'
        '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
              example:
                detail:
                  - loc:
                      - body
                      - effective_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

````