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

# Get the explanation of a past window for an inverter

> The customer-facing narrative of what this inverter's battery did over a past window, written in the organization's language unless `language` overrides it. It is generated on the first read of a window and cached, so a call that finds no cached explanation writes one and can take several seconds. `null` means no explanation exists for the window. `feedback` carries the requesting user's own rating and nobody else's.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{inverter_id}/explainer/historical
openapi: 3.1.0
info:
  title: Podero Partner API
  version: '2.0'
  description: >-
    This API provides a unified interaction point for Podero's partner
    companies.


    The goal of this API is to give partners easily integratable endpoints that
    don't require extensive software

    development. For this reason, the endpoints focus around user and device
    management, setting of preferences

    and high level device controls.


    While direct control of devices is implemented for special use cases such as
    pause power, we abstract away low level

    direct device steering so developers and partners can focus on delivering
    maximum value to end users.
  termsOfService: https://www.podero.com/terms-and-conditions
servers: []
security: []
paths:
  /api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{inverter_id}/explainer/historical:
    get:
      tags:
        - User Solar Inverters
      summary: Get the explanation of a past window for an inverter
      description: >-
        The customer-facing narrative of what this inverter's battery did over a
        past window, written in the organization's language unless `language`
        overrides it. It is generated on the first read of a window and cached,
        so a call that finds no cached explanation writes one and can take
        several seconds. `null` means no explanation exists for the window.
        `feedback` carries the requesting user's own rating and nobody else's.
      operationId: >-
        integrations_api_api_v2_organizations_users_inverters_router_get_inverter_explainer_historical
      parameters:
        - in: path
          name: org_id
          schema:
            description: The organization ID of the user's organization
            format: uuid
            title: Org Id
            type: string
          required: true
          description: The organization ID of the user's organization
        - in: path
          name: user_id
          schema:
            description: The user ID of the user whom the inverter belongs to
            format: uuid
            title: User Id
            type: string
          required: true
          description: The user ID of the user whom the inverter belongs to
        - in: path
          name: inverter_id
          schema:
            description: The ID of the specified inverter
            format: uuid
            title: Inverter Id
            type: string
          required: true
          description: The ID of the specified inverter
        - in: query
          name: start
          schema:
            description: Start of the past window to explain
            format: date-time
            title: Start
            type: string
          required: true
          description: Start of the past window to explain
        - in: query
          name: end
          schema:
            description: End of the past window to explain
            format: date-time
            title: End
            type: string
          required: true
          description: End of the past window to explain
        - in: query
          name: language
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Optional language code (e.g. 'de') overriding the organization's
              default language
            title: Language
          required: false
          description: >-
            Optional language code (e.g. 'de') overriding the organization's
            default language
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ExplainerOutput'
                  - type: 'null'
      security:
        - OAuth2: []
components:
  schemas:
    ExplainerOutput:
      description: The wire shape every device-type explainer endpoint serves.
      properties:
        id:
          description: >-
            Durable identifier of this explanation, used to dismiss it or rate
            it.
          format: uuid
          title: Id
          type: string
        explanation:
          description: The customer-facing narrative, in the resolved language.
          title: Explanation
          type: string
        feedback:
          anyOf:
            - $ref: '#/components/schemas/ExplainerFeedbackOutput'
            - type: 'null'
          description: >-
            The requesting user's own rating of this explanation, or null when
            they have not rated it.
      required:
        - id
        - explanation
        - feedback
      title: ExplainerOutput
      type: object
    ExplainerFeedbackOutput:
      properties:
        user_id:
          description: The user who rated the explainer.
          format: uuid
          title: User Id
          type: string
        helpful:
          description: Whether that user found it helpful.
          title: Helpful
          type: boolean
        reason:
          anyOf:
            - type: string
            - type: 'null'
          description: Why not, on negative feedback; null otherwise.
          title: Reason
        date:
          description: When the rating was given.
          format: date-time
          title: Date
          type: string
      required:
        - user_id
        - helpful
        - reason
        - date
      title: ExplainerFeedbackOutput
      type: object
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}
        clientCredentials:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}

````