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"
        }
    ]
}