> ## 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 current plan explanation for an inverter

> The customer-facing narrative of what this inverter's battery is planned to do next, written in the organization's language unless `language` overrides it. It is generated on the first read of a plan and cached, so a call that finds no cached explanation writes one and can take several seconds. `null` means no explanation exists for the current window — the plan may not have been solved yet. `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/current
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/current:
    get:
      tags:
        - User Solar Inverters
      summary: Get the current plan explanation for an inverter
      description: >-
        The customer-facing narrative of what this inverter's battery is planned
        to do next, written in the organization's language unless `language`
        overrides it. It is generated on the first read of a plan and cached, so
        a call that finds no cached explanation writes one and can take several
        seconds. `null` means no explanation exists for the current window — the
        plan may not have been solved yet. `feedback` carries the requesting
        user's own rating and nobody else's.
      operationId: >-
        integrations_api_api_v2_organizations_users_inverters_router_get_inverter_explainer_current
      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: 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: {}

````