---
title: "List your invitations."
method: GET
path: "/v1/org/invitations/mine"
tags: ["org"]
---

# List your invitations.

`GET /v1/org/invitations/mine`

## Request

- Base URL: `https://api.smolmachines.com`
- URL: `https://api.smolmachines.com/v1/org/invitations/mine`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/smolmachines/apis/smolfleet-api/docs/v1/org/invitations/mine/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the invitations addressed to the logged-in person's verified email. Requires a user login, not an API key.

## Response `200`

Every invitation waiting on the login's verified address, oldest first, each naming its organization; no Smol-Tenant header or members scope is needed.

- PendingInvitation[]
  - `createdAt` string, required
  - `expiresAt` string, required: When it lapses. After this it is neither listed nor acceptable.
  - `id` string, required: What the accept names, a handle not a credential; the caller's address must still match.
  - `invitedBy` string, required: The account id of the person who sent it.
  - `organization` string, required: The organization's display name, falling back to its slug, since the caller has no roster.
  - `role` string, required: The role the membership row will carry: `owner`, `admin` or `member`.
  - `tenantId` string, required: The organization it joins, for the `Smol-Tenant` header afterwards.

## Other responses

- `401`: Missing or invalid API key
- `403`: The caller authenticated with an API key rather than a user login, or has no verified address
- `429`: Rate limited; retry after the Retry-After header
- `500`: Internal error

## Changes

- **2026-10-16** `bc31fc04a568`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smolmachines/apis/smolfleet-api/changes/v1/org/invitations/mine/get.md)

---

[API](https://skmtc.dev/smolmachines/apis/smolfleet-api.md) - [All operations](https://skmtc.dev/smolmachines/apis/smolfleet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smolmachines/apis/smolfleet-api/revisions/bc31fc04a568?raw)