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

# Segment Results

> Retrieve segment-level financial results for an Indian company for a specific period. The profile determines which financial buckets are structurally applicable. A present key with a null value is applicable but unavailable; an omitted key is structurally inapplicable for that profile. Unknown source components remain visible under `segments`. `adjustments`, `inter_segment_revenue`, and standardized `un_allocable` values are independent source concepts.



## OpenAPI

````yaml openapi-india get /api/in/v0/financial-statements/segment-results
openapi: 3.0.0
info:
  title: stockinsights.ai APIs
  description: All the APIs of stockinsights.ai
  version: 1.0.0
servers:
  - url: https://stockinsights-ai-main-95a26a0.zuplo.app
security:
  - bearerAuth: []
tags:
  - name: Financial Statements
    description: Financial statements endpoints for Indian companies
paths:
  /api/in/v0/financial-statements/segment-results:
    get:
      tags:
        - Financial Statements
      summary: Segment Results
      description: >-
        Retrieve segment-level financial results for an Indian company for a
        specific period. The profile determines which financial buckets are
        structurally applicable. A present key with a null value is applicable
        but unavailable; an omitted key is structurally inapplicable for that
        profile. Unknown source components remain visible under `segments`.
        `adjustments`, `inter_segment_revenue`, and standardized `un_allocable`
        values are independent source concepts.
      operationId: getSegmentResults
      parameters:
        - $ref: '#/components/parameters/StatementTicker'
        - $ref: '#/components/parameters/PeriodEndDate'
        - $ref: '#/components/parameters/ReportingType'
        - $ref: '#/components/parameters/StatementScope'
      responses:
        '200':
          description: >-
            Successful response with segment results. Returns null data if no
            matching result is available for the requested company, period,
            reporting type, and scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SegmentResultsResponse'
              examples:
                nonbank:
                  summary: Olectra Greentech — standard nonbank structure
                  value:
                    status: success
                    data:
                      company_id: 81fc78b0f1dd4c54b990
                      profile: nonbank
                      statement_type: segment_results
                      statement_scope: consolidated
                      reporting_type: quarterly
                      fiscal_year: 2026
                      fiscal_quarter: Q4
                      period_end_date: '2026-03-31'
                      audit_status: Audited
                      currency: INR
                      scale: crores
                      financials:
                        segment_revenue_from_operations:
                          segments:
                            energy_division: 105.5216
                            mobility_division: 539.1994
                          adjustments: null
                          inter_segment_revenue: 0
                          total: 644.721
                        segment_profit_before_tax:
                          segments:
                            energy_division: 39.9777
                            mobility_division: 55.2088
                          adjustments: null
                          segment_finance_costs: 15.3738
                          other_unallocable_expenditure_net_off_unallocable_income: 0
                          total: 79.8127
                        segment_assets:
                          segments:
                            energy_division: 339.8187
                            mobility_division: 2103.0045
                          adjustments: null
                          un_allocable: 124.2865
                          total: 2567.1097
                        segment_liabilities:
                          segments:
                            energy_division: 95.5695
                            mobility_division: 1156.2186
                          adjustments: null
                          un_allocable: 82.2522
                          total: 1334.0403
                        capital_employed:
                          segments:
                            energy_division: 244.2492
                            mobility_division: 946.7859
                          adjustments: null
                          un_allocable: 42.0343
                          total: 1233.0694
                life_insurance:
                  summary: HDFC Life — life-insurance position structure
                  value:
                    status: success
                    data:
                      company_id: clmuifpolgrba5qffxb2
                      profile: life_insurance
                      statement_type: segment_results
                      statement_scope: standalone
                      reporting_type: quarterly
                      fiscal_year: 2026
                      fiscal_quarter: Q4
                      period_end_date: '2026-03-31'
                      audit_status: Unaudited
                      currency: INR
                      scale: crores
                      financials:
                        segment_assets:
                          segments:
                            segment_a_participating_individual_group_life: 77608.81
                            segment_b_participating_individual_group_pension: 2791.74
                            segment_c_non_participating_individual_group_life: 126177
                            segment_d_non_participating_life_group_variable: 2066.56
                            segment_e_non_participating_individual_group_pension: 2761.01
                            segment_f_non_participating_individual_group_pension_variable: 1889.88
                            segment_g_non_participating_individual_group_annuity: 38462.03
                            segment_h_non_participating_individual_group_health: 37.8
                            segment_i_unit_linked_individual_life: 82668.25
                            segment_j_unit_linked_individual_pension: 5353
                            segment_k_unit_linked_group_life: 15097.09
                            segment_l_unit_linked_group_pension: 2259.86
                            shareholders: 20891.18
                          adjustments: 937.57
                          total: null
                        segment_liabilities:
                          segments:
                            segment_a_participating_individual_group_life: 75535.62
                            segment_b_participating_individual_group_pension: 2608.97
                            segment_c_non_participating_individual_group_life: 126375.66
                            segment_d_non_participating_life_group_variable: 2090.33
                            segment_e_non_participating_individual_group_pension: 2578.08
                            segment_f_non_participating_individual_group_pension_variable: 1880.4
                            segment_g_non_participating_individual_group_annuity: 38295.37
                            segment_h_non_participating_individual_group_health: 42.25
                            segment_i_unit_linked_individual_life: 83110.47
                            segment_j_unit_linked_individual_pension: 5353
                            segment_k_unit_linked_group_life: 15115.78
                            segment_l_unit_linked_group_pension: 2259.86
                            shareholders: 20795.07
                          adjustments: 0
                          total: null
                        capital_employed:
                          segments:
                            segment_a_participating_individual_group_life: 2073.19
                            segment_b_participating_individual_group_pension: 182.77
                            segment_c_non_participating_individual_group_life: -198.66
                            segment_d_non_participating_life_group_variable: -23.77
                            segment_e_non_participating_individual_group_pension: 182.93
                            segment_f_non_participating_individual_group_pension_variable: 9.48
                            segment_g_non_participating_individual_group_annuity: 166.66
                            segment_h_non_participating_individual_group_health: -4.45
                            segment_i_unit_linked_individual_life: -442.22
                            segment_j_unit_linked_individual_pension: 0
                            segment_k_unit_linked_group_life: -18.69
                            segment_l_unit_linked_group_pension: 0
                            shareholders: 96.11
                          adjustments: 937.57
                          total: null
                general_insurance:
                  summary: ICICI Lombard — general-insurance duration structure
                  value:
                    status: success
                    data:
                      company_id: 0pwz9oo83rebkfit8wh7
                      profile: general_insurance
                      statement_type: segment_results
                      statement_scope: standalone
                      reporting_type: quarterly
                      fiscal_year: 2026
                      fiscal_quarter: Q4
                      period_end_date: '2026-03-31'
                      audit_status: Audited
                      currency: INR
                      scale: crores
                      financials:
                        segment_revenue_from_operations:
                          segments:
                            crop: 19.77
                            fire: 223.49
                            group_and_corporate: 314.5
                            health_government_schemes: 3.34
                            health_group: 1867.5
                            health_including_personal_accident: 0
                            health_retail: 637.9
                            marine: 171.36
                            motor: 3338.5
                            retail: 42.4
                          adjustments: null
                          total: 6618.76
                        segment_operating_profit_or_loss:
                          segments:
                            crop: 53.11
                            fire: 176.89
                            group_and_corporate: 97.74
                            health_government_schemes: -0.21
                            health_group: -22.95
                            health_including_personal_accident: 0
                            health_retail: -13.61
                            marine: -8.4
                            motor: 249.52
                            retail: 13.76
                          adjustments: null
                          total: 545.85
                investment_trust:
                  summary: Nexus Select Trust — unavailable position buckets are null
                  value:
                    status: success
                    data:
                      company_id: _dxXVMl6cOAvaTGp3lFcO
                      profile: investment_trust
                      statement_type: segment_results
                      statement_scope: consolidated
                      reporting_type: quarterly
                      fiscal_year: 2026
                      fiscal_quarter: Q4
                      period_end_date: '2026-03-31'
                      audit_status: Audited
                      currency: INR
                      scale: crores
                      financials:
                        segment_revenue_from_operations:
                          segments:
                            hospitality: 51.84
                            mall: 565.28
                            office: 35.99
                            others: 4.76
                          adjustments: null
                          inter_segment_revenue: 5.5
                          total: 652.37
                        segment_profit_before_tax:
                          segments:
                            hospitality: 26.09
                            mall: 440.57
                            office: 29.22
                            others: 2.76
                          adjustments: null
                          segment_finance_costs: 113.51
                          other_unallocable_expenditure_net_off_unallocable_income: 198.47
                          total: 186.66
                        segment_assets: null
                        segment_liabilities: null
                        capital_employed: null
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    StatementTicker:
      name: ticker
      in: query
      required: true
      description: >-
        Company ticker symbol. Supports formats: plain ticker (`RELIANCE`),
        exchange-prefixed with dot (`NSE.RELIANCE`, `BSE.RELIANCE`), or colon
        (`NSE:RELIANCE`, `BSE:RELIANCE`), and BSE numeric IDs (`BSE.500325`).
        When no exchange is specified, matches against the generic stock ticker.
      schema:
        type: string
        example: RELIANCE
    PeriodEndDate:
      name: period_end_date
      in: query
      required: true
      description: End date of the reporting period in `YYYY-MM-DD` format.
      schema:
        type: string
        format: date
        example: '2025-03-31'
    ReportingType:
      name: reporting_type
      in: query
      required: true
      description: Type of reporting period.
      schema:
        type: string
        enum:
          - quarterly
          - half_yearly
          - nine_months
          - annual
        example: annual
    StatementScope:
      name: statement_scope
      in: query
      required: true
      description: Whether to retrieve consolidated or standalone financial statements.
      schema:
        type: string
        enum:
          - consolidated
          - standalone
        example: consolidated
  schemas:
    SegmentResultsResponse:
      type: object
      required:
        - status
        - data
      properties:
        status:
          type: string
          enum:
            - success
        data:
          type: object
          nullable: true
          description: >-
            Profile-specific segment results. Null when no matching result is
            available.
          oneOf:
            - $ref: '#/components/schemas/StandardSegmentResultsData'
            - $ref: '#/components/schemas/LifeInsuranceSegmentResultsData'
            - $ref: '#/components/schemas/GeneralInsuranceSegmentResultsData'
            - $ref: '#/components/schemas/InvestmentTrustSegmentResultsData'
          discriminator:
            propertyName: profile
            mapping:
              bank:
                $ref: '#/components/schemas/StandardSegmentResultsData'
              nonbank:
                $ref: '#/components/schemas/StandardSegmentResultsData'
              life_insurance:
                $ref: '#/components/schemas/LifeInsuranceSegmentResultsData'
              general_insurance:
                $ref: '#/components/schemas/GeneralInsuranceSegmentResultsData'
              investment_trust:
                $ref: '#/components/schemas/InvestmentTrustSegmentResultsData'
    StandardSegmentResultsData:
      allOf:
        - $ref: '#/components/schemas/SegmentResultsDataBase'
        - type: object
          properties:
            profile:
              type: string
              enum:
                - bank
                - nonbank
            financials:
              $ref: '#/components/schemas/StandardSegmentFinancials'
    LifeInsuranceSegmentResultsData:
      allOf:
        - $ref: '#/components/schemas/SegmentResultsDataBase'
        - type: object
          properties:
            profile:
              type: string
              enum:
                - life_insurance
            financials:
              $ref: '#/components/schemas/LifeInsuranceSegmentFinancials'
    GeneralInsuranceSegmentResultsData:
      allOf:
        - $ref: '#/components/schemas/SegmentResultsDataBase'
        - type: object
          properties:
            profile:
              type: string
              enum:
                - general_insurance
            financials:
              $ref: '#/components/schemas/GeneralInsuranceSegmentFinancials'
    InvestmentTrustSegmentResultsData:
      allOf:
        - $ref: '#/components/schemas/SegmentResultsDataBase'
        - type: object
          properties:
            profile:
              type: string
              enum:
                - investment_trust
            financials:
              $ref: '#/components/schemas/InvestmentTrustSegmentFinancials'
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              status:
                type: string
                description: Error status
              title:
                type: string
                description: Error description
              message:
                type: string
                description: Detailed error message (optional)
    SegmentResultsDataBase:
      type: object
      required:
        - company_id
        - profile
        - statement_type
        - statement_scope
        - reporting_type
        - fiscal_year
        - fiscal_quarter
        - period_end_date
        - audit_status
        - currency
        - scale
        - financials
      properties:
        company_id:
          type: string
          description: Internal company identifier.
        profile:
          type: string
          enum:
            - bank
            - nonbank
            - life_insurance
            - general_insurance
            - investment_trust
          description: Profile discriminator for the financials object.
        statement_type:
          type: string
          enum:
            - segment_results
        statement_scope:
          type: string
          enum:
            - consolidated
            - standalone
        reporting_type:
          type: string
          enum:
            - quarterly
            - half_yearly
            - nine_months
            - annual
        fiscal_year:
          type: integer
        fiscal_quarter:
          type: string
          enum:
            - Q1
            - Q2
            - Q3
            - Q4
        period_end_date:
          type: string
          format: date
        audit_status:
          type: string
          nullable: true
        currency:
          type: string
          enum:
            - INR
        scale:
          type: string
          enum:
            - crores
        financials:
          type: object
          description: >-
            Profile-specific segment financials. Null keys are applicable but
            unavailable; structurally inapplicable keys are omitted.
    StandardSegmentFinancials:
      type: object
      required:
        - segment_revenue_from_operations
        - segment_profit_before_tax
        - segment_assets
        - segment_liabilities
        - capital_employed
      properties:
        segment_revenue_from_operations:
          $ref: '#/components/schemas/SegmentRevenueFromOperations'
        segment_profit_before_tax:
          $ref: '#/components/schemas/SegmentProfitBeforeTax'
        segment_assets:
          $ref: '#/components/schemas/SegmentPosition'
        segment_liabilities:
          $ref: '#/components/schemas/SegmentPosition'
        capital_employed:
          $ref: '#/components/schemas/SegmentPosition'
    LifeInsuranceSegmentFinancials:
      type: object
      description: >-
        Life-insurance filings structurally expose position buckets only;
        revenue and profit keys are omitted.
      required:
        - segment_assets
        - segment_liabilities
        - capital_employed
      properties:
        segment_assets:
          $ref: '#/components/schemas/LifeInsuranceSegmentPosition'
        segment_liabilities:
          $ref: '#/components/schemas/LifeInsuranceSegmentPosition'
        capital_employed:
          $ref: '#/components/schemas/LifeInsuranceSegmentPosition'
    GeneralInsuranceSegmentFinancials:
      type: object
      description: >-
        General-insurance filings structurally expose derived revenue and
        operating profit only; position keys are omitted.
      required:
        - segment_revenue_from_operations
        - segment_operating_profit_or_loss
      properties:
        segment_revenue_from_operations:
          $ref: '#/components/schemas/GeneralInsuranceSegmentMetric'
        segment_operating_profit_or_loss:
          $ref: '#/components/schemas/GeneralInsuranceSegmentMetric'
    InvestmentTrustSegmentFinancials:
      type: object
      required:
        - segment_revenue_from_operations
        - segment_profit_before_tax
        - segment_assets
        - segment_liabilities
        - capital_employed
      properties:
        segment_revenue_from_operations:
          $ref: '#/components/schemas/SegmentRevenueFromOperations'
        segment_profit_before_tax:
          $ref: '#/components/schemas/SegmentProfitBeforeTax'
        segment_assets:
          $ref: '#/components/schemas/SegmentPosition'
        segment_liabilities:
          $ref: '#/components/schemas/SegmentPosition'
        capital_employed:
          $ref: '#/components/schemas/SegmentPosition'
    SegmentRevenueFromOperations:
      type: object
      required:
        - segments
        - adjustments
        - inter_segment_revenue
        - total
      properties:
        segments:
          $ref: '#/components/schemas/SegmentValues'
        adjustments:
          type: number
          nullable: true
          description: >-
            Signed sum of reviewed reconciliation components. Null when no
            mapped source rows exist.
        inter_segment_revenue:
          type: number
          nullable: true
          description: >-
            Source-reported inter-segment revenue. This remains independent from
            adjustments.
        total:
          type: number
          nullable: true
          description: >-
            Source-reported net segment revenue total. General-insurance revenue
            is the sum of complete derived segment values and adjustments.
    SegmentProfitBeforeTax:
      type: object
      required:
        - segments
        - adjustments
        - segment_finance_costs
        - other_unallocable_expenditure_net_off_unallocable_income
        - total
      properties:
        segments:
          $ref: '#/components/schemas/SegmentValues'
        adjustments:
          type: number
          nullable: true
          description: >-
            Signed sum of reviewed reconciliation components. Null when no
            mapped source rows exist.
        segment_finance_costs:
          type: number
          nullable: true
          description: Source-reported segment finance costs.
        other_unallocable_expenditure_net_off_unallocable_income:
          type: number
          nullable: true
          description: Source-reported unallocable expenditure net of unallocable income.
        total:
          type: number
          nullable: true
          description: Source-reported profit before tax total.
    SegmentPosition:
      type: object
      nullable: true
      description: >-
        Applicable segment-position bucket. Null means that meaningful position
        facts are unavailable.
      required:
        - segments
        - adjustments
        - un_allocable
        - total
      properties:
        segments:
          $ref: '#/components/schemas/SegmentValues'
        adjustments:
          type: number
          nullable: true
          description: Signed sum of reviewed component-level reconciliations.
        un_allocable:
          type: number
          nullable: true
          description: >-
            Standardized source-reported value outside the segment subtotal.
            This remains independent from adjustments.
        total:
          type: number
          nullable: true
          description: >-
            Source-reported position total. Capital-employed total is calculated
            only when both reported asset and liability totals exist.
    LifeInsuranceSegmentPosition:
      type: object
      required:
        - segments
        - adjustments
        - total
      properties:
        segments:
          $ref: '#/components/schemas/SegmentValues'
        adjustments:
          type: number
          nullable: true
          description: Signed sum of reviewed life-insurance reconciliation components.
        total:
          type: number
          nullable: true
          description: >-
            Source-reported total. Null when the filing does not report one;
            totals are never synthesized.
    GeneralInsuranceSegmentMetric:
      type: object
      required:
        - segments
        - adjustments
        - total
      properties:
        segments:
          $ref: '#/components/schemas/SegmentValues'
        adjustments:
          type: number
          nullable: true
          description: Signed sum of reviewed general-insurance reconciliation components.
        total:
          type: number
          nullable: true
          description: Signed sum of complete derived segment values and adjustments.
    SegmentValues:
      type: object
      description: >-
        Source component keys mapped to values in crores. Unknown component keys
        remain visible here unless they belong to a reviewed adjustment mapping.
      additionalProperties:
        type: number
  responses:
    BadRequest:
      description: Bad request - Invalid query parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            errors:
              - status: '400'
                title: Invalid field - reporting_type
                message: >-
                  reporting_type must be one of: quarterly, half_yearly,
                  nine_months, annual
    Unauthorized:
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            errors:
              - status: '401'
                title: Unauthorized
                message: Invalid or missing API key
    NotFound:
      description: Company not found for the given ticker
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            errors:
              - status: '404'
                title: Company not found
                message: 'No company found for ticker: INVALID'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            errors:
              - status: '500'
                title: Internal Server Error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````