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

# Counts of pending actions and unread information notifications, grouped by device type.

> ``action_required`` counts cues whose projection's ``action_required(events)`` is True —
the same semantic as the per-device ``action_needed`` flag, so a cue mid-resolution
(``ReauthenticationSucceeded`` event landed, cue not yet flipped to DONE) doesn't count.
``information_available`` counts unread ``InformationNotification`` rows — the source of
truth for information items — and stays consistent with ``/information``: what the count
reports, the list returns.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/org/{org_id}/notifications/status
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}/notifications/status:
    get:
      tags:
        - Notifications
      summary: >-
        Counts of pending actions and unread information notifications, grouped
        by device type.
      description: >-
        ``action_required`` counts cues whose projection's
        ``action_required(events)`` is True —

        the same semantic as the per-device ``action_needed`` flag, so a cue
        mid-resolution

        (``ReauthenticationSucceeded`` event landed, cue not yet flipped to
        DONE) doesn't count.

        ``information_available`` counts unread ``InformationNotification`` rows
        — the source of

        truth for information items — and stays consistent with
        ``/information``: what the count

        reports, the list returns.
      operationId: >-
        integrations_api_api_v2_organizations_notifications_router_get_notification_status
      parameters:
        - in: path
          name: org_id
          schema:
            description: The organization ID.
            format: uuid
            title: Org Id
            type: string
          required: true
          description: The organization ID.
        - in: query
          name: owner_id
          schema:
            anyOf:
              - format: uuid
                type: string
              - type: 'null'
            description: Restrict counts to a single owner's devices.
            title: Owner Id
          required: false
          description: Restrict counts to a single owner's devices.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationStatusOutput'
      security:
        - OAuth2: []
components:
  schemas:
    NotificationStatusOutput:
      description: >-
        A per-device-type roll-up of pending notification counts. All four
        device types are

        emitted so consumers get a predictable shape regardless of what an org
        owns.
      properties:
        electric_vehicle:
          allOf:
            - $ref: '#/components/schemas/NotificationCounts'
        heat_pump:
          allOf:
            - $ref: '#/components/schemas/NotificationCounts'
        inverter:
          allOf:
            - $ref: '#/components/schemas/NotificationCounts'
        wallbox:
          allOf:
            - $ref: '#/components/schemas/NotificationCounts'
      title: NotificationStatusOutput
      type: object
    NotificationCounts:
      description: Pending item counts for a single device type.
      properties:
        action_required:
          default: 0
          description: Pending action items (e.g. reauthentication cues) awaiting the user.
          title: Action Required
          type: integer
        information_available:
          default: 0
          description: Unread information notifications for the user.
          title: Information Available
          type: integer
      title: NotificationCounts
      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: {}

````