---
title: "The organization's invitations. A signed-in person who manages people; an API key or anyone else gets 403"
method: GET
path: "/v1/organization/invitations"
---

# The organization's invitations. A signed-in person who manages people; an API key or anyone else gets 403

`GET /v1/organization/invitations`

## Request

- Base URL: `https://api.evictionsapi.com`
- URL: `https://api.evictionsapi.com/v1/organization/invitations`
- Auth: HTTP bearer

## Response `200`

The invitations.

- object
  - `items` object[], required: Pending invitations, and those accepted, revoked or expired in the last 30 days, newest first.
    - `id` string, required
    - `email` string, required: Lower-cased.
    - `role` 'owner' | 'member' | 'viewer', required
    - `status` 'pending' | 'accepted' | 'revoked' | 'expired', required: A replaced or resent invitation is `revoked`: only the newest link to an address works.
    - `invitedBy` object, required
      - `id` string, required
      - `name` string, nullable, required
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time, required
  - `link` string: The invitation's link, returned only in local development; elsewhere it is only emailed.

## Other responses

- `400`: The request is invalid.
- `401`: The credential is missing or invalid.
- `403`: The credential is not allowed to do this (`forbidden`). For a signed-in session: `permission_denied`, the person's role in the organization lacks the permission this needs (ask an owner); `no_organization`, the person belongs to no organization yet (start one with `POST /v1/me/organizations` or accept an invitation).
- `404`: Not found.
- `409`: The request conflicts with the current state: for a case, it is not in a state that allows this, or its details were erased (`erased`); for an API key, a limit or the key in use.
- `422`: The case did not pass a check.

---

[API](https://skmtc.dev/evictionsapi/apis/evictions-api.md) · [All operations](https://skmtc.dev/evictionsapi/apis/evictions-api/llms.txt) · [OpenAPI document](https://skmtc.dev/evictionsapi/apis/evictions-api/revisions/28459213a1a3?raw)