> ## 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 Organization Invitations

> List the organization's invitations for the console tables — the newest send per email across
both invite surfaces (end-user and console staff/admin), each with its derived lifecycle status
(pending / accepted / expired / revoked / invalidated), newest first.

Restricted to staff/admin, plus Console Support reading across orgs: the list is a console-admin
surface carrying every invitee's email and role, which the org's own end users have no business
reading.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/org/{org_id}/invitations
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}/invitations:
    get:
      tags:
        - Organization
      summary: List Organization Invitations
      description: >-
        List the organization's invitations for the console tables — the newest
        send per email across

        both invite surfaces (end-user and console staff/admin), each with its
        derived lifecycle status

        (pending / accepted / expired / revoked / invalidated), newest first.


        Restricted to staff/admin, plus Console Support reading across orgs: the
        list is a console-admin

        surface carrying every invitee's email and role, which the org's own end
        users have no business

        reading.
      operationId: >-
        integrations_api_api_v2_organizations_router_list_organization_invitations
      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: query
          name: page
          schema:
            default: 1
            minimum: 1
            title: Page
            type: integer
          required: false
        - in: query
          name: page_size
          schema:
            anyOf:
              - minimum: 1
                type: integer
              - type: 'null'
            title: Page Size
          required: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedOrganizationInvitationListItemOutput'
      security:
        - OAuth2: []
components:
  schemas:
    PagedOrganizationInvitationListItemOutput:
      properties:
        items:
          items:
            $ref: '#/components/schemas/OrganizationInvitationListItemOutput'
          title: Items
          type: array
        count:
          title: Count
          type: integer
      required:
        - items
        - count
      title: PagedOrganizationInvitationListItemOutput
      type: object
    OrganizationInvitationListItemOutput:
      description: >-
        One row of the org's invitation list: the newest send per email with its
        derived lifecycle

        status. ``accepted_at`` is present only when the invite was accepted.
      properties:
        invite_id:
          format: uuid
          title: Invite Id
          type: string
        email:
          title: Email
          type: string
        role:
          title: Role
          type: string
        status:
          title: Status
          type: string
        sent_at:
          format: date-time
          title: Sent At
          type: string
        accepted_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Accepted At
      required:
        - invite_id
        - email
        - role
        - status
        - sent_at
      title: OrganizationInvitationListItemOutput
      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: {}

````