Get a single team member

Returns a single team member by their ID. This endpoint does not return pending invitations.

You can retrieve a specific member or invitation by providing an email query parameter in List all team members API.

The role attribute is the team member's role in the team your API token is scoped to. A user with different roles in different teams returns different values depending on which team's token you use. Possible values: admin, billing_admin, team_lead, responder, member, or custom. custom is returned when the user has a non-system custom role.

GET https://betterstack.com/api/v2/team-members/{id}

URL parameters

id
required string

Query parameters

team_name
string

Headers

Authorization
required string
200

Response body

{
  "data": {
    "id": "101",
    "type": "team_member",
    "attributes": {
      "email": "alice@example.com",
      "first_name": "Alice",
      "last_name": "Smith",
      "created_at": "2023-10-26T10:00:00.000Z",
      "role": "admin",
      "mobile_app_platforms": [
        "ios",
        "android"
      ]
    }
  }
}
404

Response body

{
  "errors": "Resource type user with id = 101 was not found"
}

Example cURL

Example
curl --request GET \
  --url "https://betterstack.com/api/v2/team-members/101" \
  --header "Authorization: Bearer $TOKEN"