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

id string

Unique mailing list identifier

object string

label string

Mailing list name/label

created_at integer

Unix timestamp of when the list was created

number_of_subscribers integer

Count of active subscribers (excluding unsubscribed and pending)

number_of_newsletters integer

Count of blast campaigns sent to this list

audience object

Audience segmentation configuration

last_campaign_date integer

Unix timestamp of the most recent campaign, or null if none

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

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": [
    {
      "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/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