Retrieve a mailing list

GET https://api.tamio.com/v2/mailing-lists/retrieve/{uuid}

Retrieves a single mailing list by UUID with full details including subscriber count, newsletter count, audience configuration, and last campaign date.

Path Parameters

uuid string*

UUID of the mailing list to retrieve

Responses

200 Mailing list retrieved successfully

Mailing list retrieved successfully

status integer

mailing_list MailingList

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	Mailing list not found

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Update a mailing list

Delete a mailing list

/mailing-lists/retrieve/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/mailing-lists/retrieve/{uuid}", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/mailing-lists/retrieve/{uuid}")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "mailing_list": {
    "id": "00000000-0000-0000-0000-000000000000",
    "object": "mailing_list",
    "label": "VIP Customers",
    "created_at": 1700000000,
    "number_of_subscribers": 245,
    "number_of_newsletters": 12,
    "audience": {},
    "last_campaign_date": 1704153600
  }
}

1	const response = await fetch("https://api.tamio.com/v2/mailing-lists/retrieve/{uuid}", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/mailing-lists/retrieve/{uuid}")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body