---
title: "Get team members"
method: GET
path: "/v2/teams/{team_id}/members"
---

# Get team members

`GET /v2/teams/{team_id}/members`

## Request

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

This endpoint allows API users to retrieve the list of team members, including admins.

Only team members can use the endpoint.

## Response `200`

Successful response. Returns the members of the team, including admins. To also return users who declined or have not accepted the invite to the team, add `with_declined_requests=true`.

- object
  - `data` object[]: Array of members
    - `id` string: User ID
    - `role` string: User's role (member or admin)
    - `emails` string[]: User's email addresses
    - `status` string: User's status (accepted, declined, or pending)
    - `billing` integer: Is true if member is an admin
    - `primary` boolean: Whether the user is a primary admin
    - `full_name` string: User's full name
    - `avatar_url` string: URL of the avatar image
    - `invited_by` string: Email address of the user who invited the member. Appears for pending members.
    - `request_uid` string: ID of this member's invitation request. Appears for pending members.
    - `request_role` string: Is equal to `member` if a user is not an admin
    - `can_admin_view` boolean: Whether a user is a secondary admin (not a team owner) and is not a user sending the request
    - `document_access` integer: Is true if member is an admin
    - `request_updated` number: Timestamp of when the invitation to join the team was sent to this user. Appears for pending members.
  - `meta` object: Pagination details.
    - `pagination` object: Pagination details.
      - `count` integer: Number of users on the current page
      - `links` object: Links to the adjacent pages. An empty array if there are no other pages.
        - `next` string: URL of the next page. Returned only if there is a next page.
        - `previous` string: URL of the previous page. Returned only if there is a previous page.
      - `total` integer: Number of users found
      - `per_page` integer: Number of users to be displayed on a page
      - `total_pages` integer: Total number of pages
      - `current_page` integer: Current page number

## Other responses

- `400`: * User is not team member. * Team 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)