---
title: "ListOrgInvitations"
description: "List invitations"
canonical: "https://pgbeam.com/docs/go-sdk/account/listOrgInvitations"
last-updated: "2026-10-08T10:00:49.000Z"
---

# ListOrgInvitations

> List invitations

URL: https://pgbeam.com/docs/go-sdk/account/listOrgInvitations

Lists invitations to join the organization and where each has got to.

## Usage

## Parameters

Parameter

Type

Required

Description

ctx

`context.Context`

Yes

Request context

orgID

`string`

Yes

Unique organization identifier.

params

`*pgbeam.ListOrgInvitationsParams`

No

Query parameters

params.Status

`string`

No

Filter to a single status. Omit to list every invitation.

params.PageSize

`int`

No

Maximum number of items to return (1-100, default 20).

params.PageToken

`string`

No

Opaque token for cursor-based pagination.

## Response

`(*pgbeam.ListOrgInvitationsResponse, error)`: a page of invitations.

## Example

## Errors

Status

Description

400

The request was rejected. `code` is `INVALID_INPUT`, and `errors` names the offending fields when the failure was a validation one.

401

Missing or invalid authentication. `code` is `UNAUTHORIZED`.

403

The caller is authenticated but not allowed to perform this operation. `code` is `FORBIDDEN` when the caller's role is insufficient, and `PLAN_LIMIT_REACHED` when the organization's plan is what stands in the way. The two are answered differently, so branch on the code rather than the status.

404

The resource does not exist, or the caller is not entitled to know that it does. `code` is `NOT_FOUND`.

429

Rate limited. `code` is `RATE_LIMITED`.