EmailOctopus logo

API > Lists > Get List Tags

GET https://emailoctopus.com/api/1.6/lists/:listId/tags

Get all tags on a list.

Parameters
api_key (string) Your API key.
200 (success) returns
data (array of structs)

Details of each tag:

tag (string) The name of the tag.
paging (array)

URLs to navigate the results:

previous (nullable string) A link for the immediate previous page of results.
next (nullable string) A link for the immediate next page of results.
Non-200 (error) returns

Details of the error:

code (string) The error code.
message (string) A description of the error.
API-wide error codes
INVALID_PARAMETERS Parameters are missing or invalid.
API_KEY_INVALID Your API key is invalid.
UNAUTHORISED You're not authorised to perform that action.
NOT_FOUND The requested endpoint does not exist.
UNKNOWN An unknown error has occurred.
Example request
/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags?api_key=00000000-0000-0000-0000-000000000000
Example response
                        
                            {
                                "data": [
                                    {
                                        "tag": "tag1"
                                    },
                                    {
                                        "tag": "tag2"
                                    }
                                ],
                                "paging": {
                                    "previous": null,
                                    "next": null
                                }
                            }
                        
                    
Code sample
copy
curl -X GET https://emailoctopus.com/api/1.6/lists/00000000-0000-0000-0000-000000000000/tags?api_key=00000000-0000-0000-0000-000000000000