# Teammates API Reference

Source: https://instatus.com/help/api/teammates

## Get teammates

**Endpoint:**

```bash
GET /v1/:page_id/team?page=:page&per_page=:per_page
```

- The default page number is 1.
- The default per_page number is 50 and the maximum is 100 items per page.

**Example response**

```json
[
  {
    "id": "cm1111x6ofgsd5666mzxcw978qh",
    "user": {
      "id": "cm111114566gsd5666mzxcw978qh",
      "name": "Ali Salah",
      "email": "ali@instatus.com",
      "avatar": "https://res.cloudinary.com/sup/image/upload/v1600287654/avatars/uuhfbauwwv7zjzzejgik.jpg"
    }
  }
]
```

## Add a team member

```bash
POST /v1/:page_id/team
```

**Example request**

```json
{
  "email": "john@instatus.com"
}
```

**Example response**

```json
{
    "id": "cm1111x6ofgsd5666mzxcw978qh",
    "email": "john@instatus.com"
}
```

## Delete a team member

```bash
DELETE /v1/:page_id/team/:member_id
```

**Example response**

```json
{
    "memberId": "cm1111x6ofgsd5666mzxcw978qh"
}
```
