My Invitations
List the pending account invitations addressed to you — across every account that has invited your email. This is the invitee side of the flow: an account admin invites your email, you see the invite here, then accept or decline it.
Invitations are resolved by your account's email address. Only invitations that are still pending and not expired are returned; accepted, declined, revoked, and expired invites are omitted.
Response (200 OK)
Returns an array of invitation objects under the invitations key (an empty array when you have none).
id int64
Invitation ID. Use it with the accept / decline endpoints.
account_id int64
The account inviting you.
account_name string
Display name of the inviting account, for showing in a prompt.
invited_email string
The email the invite was addressed to (your email).
role_id int64
Role you'll be granted on acceptance.
role_name string
Display name of that role.
inviter_name string
Display name of the person who invited you.
status string
Always
pending for entries returned here.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.
500
Database error loading invitations.
Request
curl "https://api.ngris.com/v1/user/invitations" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
for inv in client.users.list_invitations():
print(inv["account_name"], "as", inv["role_name"])
Response — 200 OK
{
"invitations": [
{
"id": 42,
"account_id": 18,
"account_name": "Acme Inc",
"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"
}
]
}