---
title: "Get Invites"
method: GET
path: "/v2/invites"
tags: ["B2B Invites"]
---

# Get Invites

`GET /v2/invites`

List all pending invites for a company or team. User must be team_admin for teams or org_admin for companies.

## Query parameters

- `nanoid` union, required
  - string — Identifier of a Rise team (a workspace below a company). 15-character nanoid prefixed with `te-`.
  - string — Identifier of a Rise company. 15-character nanoid prefixed with `co-` (e.g. `co-aBcD1234EfGh`).

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object[], required
    - `nanoid` string, required
    - `role` 'org_admin' | 'org_finance_admin' | 'org_viewer' | 'org_hr_admin' | 'org_delegate_admin' | 'org_non_delegate_admin' | 'team_admin' | 'team_viewer' | 'team_finance_admin' | 'team_delegate_admin' | 'team_non_delegate_admin' | 'team_payment_initiator' | 'contractor' | 'team_employee' | 'aor_contractor' | 'team_hr_admin', nullable, required
    - `invitee_name` string, required
    - `email` string, email, required
    - `inviter_name` string, required
    - `inviter_email` string, email, required
    - `company` object
      - `name` string, required
      - `avatar` string, required
    - `team` object
      - `name` string, required
      - `avatar` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/riseworks/apis/b2b-api-v1-legacy.md) · [All operations](https://skmtc.net/riseworks/apis/b2b-api-v1-legacy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/riseworks/b2b-api-v1-legacy/revisions/6f6941749255/schema)