# Team Members API

The Team Members API allows you to programmatically retrieve the members and permissions associated with your Hosted Graphite team.

<mark style="color:green;">`GET`</mark> `/team/members/`

Returns a list of users associated with your team, and their respective permissions.

{% tabs %}
{% tab title="200" %}
Success
{% endtab %}

{% tab title="500" %}
Internal Server Error
{% endtab %}
{% endtabs %}

**Example JSON response:**

```json
{
  "total_users": 2,
  "users": [
    {
      "user": "admin@example.com",
      "permission": "Team Manager"
    },
    {
      "user": "user@example.com",
      "permission": "Read and Write"
    }
  ]
}
```

**Curl example:**

```bash
curl -X GET "https://<API-KEY>@api.hostedgraphite.com/team/members/"
```

Additional routes for this (create, update, delete) are currently on our development roadmap!