> For the complete documentation index, see [llms.txt](https://docs.hostedgraphite.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hostedgraphite.com/api-guides/team-members-api.md).

# 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!