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).
uuid string (uuid)
The invitation's public id. Use it with the accept / decline endpoints.
account_uuid string (uuid)
The
uuid of 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_uuid string (uuid)
The
uuid of the 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.
invited_by_user_uuid string (uuid)
The
uuid 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. Omitted when no expiry is set.
created_at, updated_at datetime
RFC 3339 UTC timestamps.
Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.
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._get_raw("/user/invitations")["invitations"]:
print(inv["account_name"], "as", inv["role_name"])
Response — 200 OK
{
"invitations": [
{
"uuid": "019a89b0-bb2b-76eb-8f22-cf9745345430",
"account_uuid": "019a6e8e-a31d-751c-96b0-440186b7f3a8",
"account_name": "Acme Inc",
"invited_email": "teammate@example.com",
"role_uuid": "019a9625-4dd4-7506-aa4b-97bbf9a69640",
"role_name": "Developer",
"invited_by_user_uuid": "019a52c2-ca1e-78ba-ab5c-50362cc29134",
"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"
}
]
}
Was this helpful?