# List of Tokens

#### Endpoint

`GET https://api.mailjet.com/v1/REST/tokens/`

To effectively manage and monitor your tokens, you can retrieve a comprehensive list of all tokens created. This allows for easy oversight and management of token permissions and statuses.

### Query Parameters

Sort is available for `Name`.

| Name | Type | Description |
|  --- | --- | --- |
| `Name` | string | Will only return an exact match. |


### Example Request

```
curl --request GET \
  --url https://api.mailjet.com/v1/rest/tokens \
  --header 'Authorization: Bearer 612d5125131d406081abb9cd2afdc4e3' \
```

Status code: `200`

### Response Data Field Structure

| Name | Type | Description |
|  --- | --- | --- |
| `ID` | integer | The ID of the token. |
| `Name` | string | Required. A unique identifier for the token. |
| `Permissions` | array of strings | List of permissions assigned to the token. See full list of permissions. |
| `ExpiresAt` | Date RFC3339 | Date at which the token expires. |
| `CreatedAt` | Date RFC3339 | Date on which the token was created. |
| `UpdatedAt` | Date RFC3339 | Date on which the token was last updated. |


### API Response Example

```
{
    "Count": 1,
    "Total": 1,
    "Data": [
        {
            "ID": 1,
            "UserID": 2,
            "OrganisationID": 2,
            "AccessToken": null,
            "Name": "marketing team",
            "Permissions": [
                "read_template_marketing",
                "create-template_marketing",
                "update_template_marketing"
            ],
            "CreatedAt": "2024-03-19T10:19:37.911136Z",
            "UpdatedAt": "2024-03-19T10:19:37.911136Z"
        }
    ]
}
```