---
title: "List the pending invitations sent to the signed-in user."
method: GET
path: "/invitations"
tags: ["invitations"]
---

# List the pending invitations sent to the signed-in user.

`GET /invitations`

## Request

- Base URL: `https://api.shorebird.dev/api/v1`
- URL: `https://api.shorebird.dev/api/v1/invitations`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Invitations to join an organization, or to collaborate on an app,
sent to the signed-in user's email address, most recently sent
first. The email matches without regard to case. Accepted,
declined, revoked and expired invitations are left out. Service
accounts have no email and are refused with a `403`.

## Query parameters

- `per_page` integer
- `cursor` string

## Response `200`

One page of the signed-in user's pending invitations.

- GetReceivedInvitationsResponse: The response body for GET /invitations.
  - `invitations` ReceivedInvitation[], required: The invitations on this page, most recently sent first.
    - `id` string, uuid, required: The ID of the invitation, which accepting or declining it takes.
    - `organization_id` integer: The organization the invitation is to, for an organization invitation.
    - `app_id` string: The app the invitation is to, for an app invitation.
    - `target_name` string, required: The organization's name or the app's display name.
    - `inviter_email` string, required: The email of the user who sent the invitation.
    - `role` 'owner' | 'admin' | 'appManager' | 'developer' | 'viewer' | 'auditor' | 'scim' | 'none', required: A role that a user can have relative to an Organization or App.
    - `created_at` string, date-time, required: When the invitation was sent.
    - `expires_at` string, date-time, required: When the invitation stops being valid.
  - `next_cursor` string: The opaque cursor of the next page; send it back as `cursor` to get that page. Absent on the last page.

## Other responses

- `default`: Standard error response. Emitted for any non-2xx status where a body can be decoded into an [ErrorResponse].

---

[API](https://skmtc.dev/shorebird/apis/shorebird-codepush-api.md) - [All operations](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/revisions/941da8871d10?raw)