API > Lists > Get List

GET https://emailoctopus.com/api/1.2/lists/:listId

Get details of a list.

api_key (string) Your API key.
200 (Success) Returns

Details of the list:

id (string) The identifier of the list.
name (string) The name of the list.
created_at (string) When the list was created, in ISO 8601 format.
Non-200 (Error) Returns

Details of the error:

code (string) The error code.
message (string) A description of the error.
Method-specific Error Codes
LIST_NOT_FOUND The list could not be found.
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
Example Response
                                "id": "00000000-0000-0000-0000-000000000000",
                                "name": "Foo",
                                "created_at": "2017-11-20T00:00:00+00:00"