List Account Invites
List the invitations issued for the active account — the admin-side view of everyone who has been invited to join. Use it to render a "pending invites" table and to find the invite id you need for revoking.
The active account is taken from your session/API key context. Requires the members:read permission.
Query parameters
pending string optional
Pass
pending=1 to return only invitations still awaiting a response. Omit (or any other value) to return invitations in every state.Response (200 OK)
Returns an array of invitation objects under the invitations key (an empty array when there are none).
id int64
Invitation ID.
invited_email string
Email the invite was addressed to.
role_id int64
Role granted on acceptance.
role_name string
Display name of that role, for convenience.
invited_by_user_id int64
User who issued the invite.
inviter_name string
Display name of the inviter.
status string
One of
pending, accepted, declined, expired, revoked.expires_at datetime
When the invitation lapses if not acted on. May be omitted.
created_at, updated_at datetime
RFC 3339 UTC timestamps.
Errors
401 Unauthorized
Missing or invalid auth.
403 Forbidden
Your role lacks the
members:read permission on the active account.500
Database error loading invitations.
Request
curl "https://api.ngris.com/v1/account/invites?pending=1" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
invites = client.account.list_invites(pending=True)
for inv in invites:
print(inv["invited_email"], inv["status"])
Response — 200 OK
{
"invitations": [
{
"id": 42,
"account_id": 18,
"invited_email": "teammate@example.com",
"role_id": 7,
"role_name": "Developer",
"invited_by_user_id": 1024,
"inviter_name": "alice",
"status": "pending",
"expires_at": "2026-06-06T13:00:00Z",
"created_at": "2026-05-30T13:00:00Z",
"updated_at": "2026-05-30T13:00:00Z"
}
]
}