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

# Assess IFRS 9 Impairment Stage

> Determines the IFRS 9 impairment stage (Stage 1, 2, or 3) for a financial asset based on credit deterioration indicators. Stage 1: 12-month ECL for performing loans with no significant increase in credit risk (SICR). Stage 2: Lifetime ECL for loans with SICR but not credit-impaired (typically 30+ days past due, rating downgrades, or PD increase). Stage 3: Lifetime ECL for credit-impaired assets (typically 90+ days past due or objective evidence of impairment). Use this for loan loss provisioning, financial reporting, and regulatory submissions under IFRS 9. [Tier: ENTERPRISE, Credits: 10]



## OpenAPI

````yaml api-specs/regulatory.json post /quantlib/regulatory/ifrs9/stage-assessment
openapi: 3.1.0
info:
  title: FinceptQuantLib API - Regulatory
  description: >-
    Pro-tier regulatory compliance and capital adequacy endpoints covering Basel
    III capital ratios and RWA calculations, SA-CCR counterparty credit risk
    exposure metrics, IFRS 9 expected credit loss provisioning, liquidity
    coverage ratios (LCR/NSFR), and stress testing capital projections. All
    endpoints require Pro tier access and consume 5 credits per request.
  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-regulatory
    description: >-
      Regulatory compliance and capital adequacy calculations for Basel III,
      SA-CCR, IFRS 9, liquidity ratios, and stress testing. Pro tier required.
    x-displayName: Regulatory
paths:
  /quantlib/regulatory/ifrs9/stage-assessment:
    post:
      tags:
        - quantlib-regulatory
      summary: Assess IFRS 9 Impairment Stage
      description: >-
        Determines the IFRS 9 impairment stage (Stage 1, 2, or 3) for a
        financial asset based on credit deterioration indicators. Stage 1:
        12-month ECL for performing loans with no significant increase in credit
        risk (SICR). Stage 2: Lifetime ECL for loans with SICR but not
        credit-impaired (typically 30+ days past due, rating downgrades, or PD
        increase). Stage 3: Lifetime ECL for credit-impaired assets (typically
        90+ days past due or objective evidence of impairment). Use this for
        loan loss provisioning, financial reporting, and regulatory submissions
        under IFRS 9. [Tier: ENTERPRISE, Credits: 10]
      operationId: ifrs9_stage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - days_past_due
                - rating_downgrade
                - pd_increase_ratio
              properties:
                days_past_due:
                  type: integer
                  description: >-
                    Number of days payment is past due (0 = current, 30+
                    triggers Stage 2, 90+ triggers Stage 3)
                  minimum: 0
                  example: 45
                rating_downgrade:
                  type: integer
                  description: >-
                    Number of notches in credit rating downgrade since
                    origination (2+ typically triggers Stage 2)
                  minimum: 0
                  example: 2
                pd_increase_ratio:
                  type: number
                  description: >-
                    Ratio of current PD to origination PD (>2.0 often indicates
                    SICR and triggers Stage 2)
                  minimum: 0
                  example: 2.5
                is_credit_impaired:
                  type: boolean
                  description: >-
                    Whether there is objective evidence of credit impairment
                    (default, bankruptcy, restructuring) - forces Stage 3
                  default: false
                  example: false
            examples:
              stage_1_performing:
                summary: Stage 1 - Performing loan
                value:
                  days_past_due: 0
                  rating_downgrade: 0
                  pd_increase_ratio: 1.1
                  is_credit_impaired: false
              stage_2_sicr:
                summary: Stage 2 - Significant increase in credit risk
                value:
                  days_past_due: 45
                  rating_downgrade: 2
                  pd_increase_ratio: 2.5
                  is_credit_impaired: false
              stage_3_impaired:
                summary: Stage 3 - Credit impaired
                value:
                  days_past_due: 120
                  rating_downgrade: 5
                  pd_increase_ratio: 8
                  is_credit_impaired: true
      responses:
        '200':
          description: IFRS 9 stage assessed successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      stage:
                        type: string
                        description: IFRS 9 stage name (STAGE_1, STAGE_2, or STAGE_3)
                        example: STAGE_2
                      stage_value:
                        type: integer
                        description: Numeric stage value (1, 2, or 3)
                        example: 2
              examples:
                stage_2:
                  summary: Stage 2 assessment
                  value:
                    success: true
                    data:
                      stage: STAGE_2
                      stage_value: 2
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '402':
          $ref: '#/components/responses/InsufficientCreditsError'
        '422':
          $ref: '#/components/responses/ValidationError'
components:
  responses:
    UnauthorizedError:
      description: Authentication information is missing or invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              detail:
                type: string
                example: Invalid API key
    InsufficientCreditsError:
      description: Insufficient API credits to complete request
      content:
        application/json:
          schema:
            type: object
            properties:
              detail:
                type: string
                example: Insufficient credits. This endpoint requires 5 credits.
    ValidationError:
      description: Request 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
                  - cet1_capital
                msg: field required
                type: value_error.missing
  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

````