List all mailing lists

GET https://api.tamio.com/v2/mailing-lists/list

Returns a paginated list of mailing lists with filtering options including text search, date ranges, and filtering by associated customer, subscriber, or teammate.

Query Parameters

page integer*

per_page integer*

order string

ascdesc

sort_by string

datelabel

filter string

Text search against mailing list names/labels

customer_id string

Filter lists containing a specific customer UUID

subscriber_id string

Filter lists containing a specific subscriber UUID

teammate_id string

Filter lists managed by a specific teammate UUID

from string

Start date filter (ISO format or Unix timestamp)

to string

End date filter (ISO format or Unix timestamp)

Responses

200 Mailing lists retrieved successfully

Mailing lists retrieved successfully

status integer

total_results integer

Total number of mailing lists matching the query

mailing_lists array of MailingList

400 Bad request. Possible `error_code` values:

Bad request. Possible error_code values:

Code	Description
`1002`	ResourceNotFound

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Create a mailing list

/mailing-lists/list

1 const response = await fetch("https://api.tamio.com/v2/mailing-lists/list", {
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/list")
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,
  "total_results": 12,
  "mailing_lists": []
}

1	const response = await fetch("https://api.tamio.com/v2/mailing-lists/list", {
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/list")
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