---
title: "Get team invite"
method: GET
path: "/team/{request_id}/request"
---

# Get team invite

`GET /team/{request_id}/request`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/team/{request_id}/request`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/team/:request_id/request/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to get information about a user's team invite.

## Response `200`

Team invite details. Possible values of `request_status`:

* `waiting`: the user has not accepted or declined the invite.
* `approved`: the user accepted the invite.
* `declined`: the user declined the invite.
* `denied`: the invite was rejected by a team admin.
* `unknown`: an error occurred.

- object
  - `role` string: Role the user gets in the team, for example `user`.
  - `team_id` string: ID of the team.
  - `team_name` string: Name of the team.
  - `request_id` string: ID of the team invite.
  - `request_status` string: Status of the invite: `waiting`, `approved`, `declined`, `denied`, or `unknown`.

## Other responses

- `400`: * The invite is not for this user. * Invite not found.

---

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