Get List

Retrieve a specific list by UUID, including contact count.

Request

GET /lists/{uuid}

Path Parameters

Parameter	Type	Description
uuid	string	List's UUID

Example Request

curl -X GET "https://email.easy.tools/api/v1/lists/list-uuid-123" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Response

Success Response (200 OK)

{
  "data": {
    "uuid": "list-uuid-123",
    "name": "Newsletter Subscribers",
    "description": "Main newsletter list",
    "is_public": true,
    "contacts_count": 150,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z"
  }
}

Response Fields

Field	Type	Description
uuid	string	List's unique identifier
name	string	List name
description	string|null	Public description
is_public	boolean	Whether the list is public
contacts_count	integer	Number of contacts in the list
created_at	string	ISO 8601 timestamp (UTC)
updated_at	string	ISO 8601 timestamp (UTC)

Error Responses

Not Found Error (404)

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "List with uuid 'list-uuid-123' not found"
  }
}