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

# List an organization's information notifications.

> Newest-first history of information notifications across the organization, bounded at SQL.
Resolution links are minted per record for that notification's owner.

``code`` filters on the linked cue's code, so cue-less sends drop out under a code filter.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/org/{org_id}/notifications/information
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/information:
    get:
      tags:
        - Notifications
      summary: List an organization's information notifications.
      description: >-
        Newest-first history of information notifications across the
        organization, bounded at SQL.

        Resolution links are minted per record for that notification's owner.


        ``code`` filters on the linked cue's code, so cue-less sends drop out
        under a code filter.
      operationId: >-
        integrations_api_api_v2_organizations_notifications_router_list_information_notifications
      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 to a single owner's notifications.
            title: Owner Id
          required: false
          description: Restrict to a single owner's notifications.
        - in: query
          name: device_id
          schema:
            anyOf:
              - format: uuid
                type: string
              - type: 'null'
            description: Restrict to a single device's notifications.
            title: Device Id
          required: false
          description: Restrict to a single device's notifications.
        - in: query
          name: device_type
          schema:
            anyOf:
              - $ref: '#/components/schemas/DeviceField'
              - type: 'null'
            description: Restrict to one device type.
          required: false
          description: Restrict to one device type.
        - in: query
          name: code
          schema:
            anyOf:
              - items:
                  $ref: '#/components/schemas/CueCode'
                type: array
              - type: 'null'
            description: >-
              Restrict to notifications whose cue carries one of these codes
              (repeatable).
            title: Code
          required: false
          description: >-
            Restrict to notifications whose cue carries one of these codes
            (repeatable).
        - in: query
          name: created_after
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: Only notifications sent at or after this time.
            title: Created After
          required: false
          description: Only notifications sent at or after this time.
        - in: query
          name: created_before
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            description: Only notifications sent at or before this time.
            title: Created Before
          required: false
          description: Only notifications sent at or before this time.
        - in: query
          name: limit
          schema:
            default: 50
            description: Page size.
            maximum: 100
            minimum: 1
            title: Limit
            type: integer
          required: false
          description: Page size.
        - in: query
          name: offset
          schema:
            default: 0
            description: Items to skip.
            minimum: 0
            title: Offset
            type: integer
          required: false
          description: Items to skip.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/NotificationHistoryItem'
                title: Response
                type: array
      security:
        - OAuth2: []
components:
  schemas:
    DeviceField:
      description: >-
        A device type's ORM relation name — and the key into its state-store
        binding.


        The value doubles as the related-name used in ORM kwargs (e.g.
        ``HeatPumpDataPoint(heat_pump=…)``),

        so this is a ``StrEnum`` to stay interchangeable with that string at
        those sites.
      enum:
        - heat_pump
        - inverter
        - electric_vehicle
        - wallbox
      title: DeviceField
      type: string
    CueCode:
      enum:
        - reauthenticate
        - virtual_key_required
        - subscription_required
        - remote_access_disabled
        - terms_not_accepted
        - discarded
        - information
        - steering_recovery_failed
        - oem_charge_cap_detected
        - wallbox_current_cap_detected
        - battery_mode_reset_failed
        - device_offline
        - fully_charged
        - soc_input_requested
        - vendor_access_required
        - premium_subscription_required
      title: CueCode
      type: string
    NotificationHistoryItem:
      description: >-
        View item for a member's notification history — the projected shape of a
        NotificationRecorded.
      properties:
        id:
          description: The notification's id.
          format: uuid
          title: Id
          type: string
        message:
          description: The message shown to the user.
          title: Message
          type: string
        sent_at:
          description: When the notification was sent.
          format: date-time
          title: Sent At
          type: string
        dismissed:
          description: Whether the user has already dismissed it.
          title: Dismissed
          type: boolean
        device_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          description: The device the notification relates to, if any.
          title: Device Id
        device_type:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The device's type key (e.g. `electric_vehicle`), matching the status
            roll-up keys.
          title: Device Type
        origin_code:
          allOf:
            - $ref: '#/components/schemas/CueCode'
          default: information
          description: >-
            The originating cue code (e.g. `device_offline`), so callers
            rank/label by real severity. `information` for a cue-less
            manual/bulk send.
        owner:
          anyOf:
            - $ref: '#/components/schemas/OwnerIdentity'
            - type: 'null'
          description: >-
            The device owner (id + email/name), so callers skip the device→owner
            lookup.
        resolution_link:
          $ref: '#/components/schemas/ResolutionLinkSchema'
          description: Link the caller follows to dismiss it.
      required:
        - id
        - message
        - sent_at
        - dismissed
        - resolution_link
      title: NotificationHistoryItem
      type: object
    OwnerIdentity:
      description: >-
        The device owner inlined on device-keyed projections, so a caller
        resolves

        device→owner→user from the row itself instead of fetching the whole
        device list.
      properties:
        id:
          description: The owner member's id.
          format: uuid
          title: Id
          type: string
        email:
          anyOf:
            - type: string
            - type: 'null'
          description: The owner's email, if known.
          title: Email
        first_name:
          anyOf:
            - type: string
            - type: 'null'
          description: The owner's first name, if known.
          title: First Name
        last_name:
          anyOf:
            - type: string
            - type: 'null'
          description: The owner's last name, if known.
          title: Last Name
      required:
        - id
      title: OwnerIdentity
      type: object
    ResolutionLinkSchema:
      properties:
        url:
          description: >-
            Relative URL the caller hits to resolve the action. Already includes
            the action's ID and a signed `secret` query parameter; the secret is
            bound to the member and expires 1 hour after issuance.
          title: Url
          type: string
        required_parameters:
          description: >-
            Names of the body fields the caller must supply when resolving the
            action.
          items:
            type: string
          title: Required Parameters
          type: array
      required:
        - url
        - required_parameters
      title: ResolutionLinkSchema
      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: {}

````