List all customers

GET https://api.tamio.com/v2/customers/list

Returns a paginated list of customers. Supports filtering by name, email, country, date range, teammate, automation, product, and affiliate program. Leads can be optionally included via the include_leads parameter.

Query Parameters

page integer*

per_page integer*

order string

ascdesc

sort_by string

nameemailcountrycreated_at

filter string

Search by name, email, or other fields

from string

Start date filter (ISO 8601 or unix timestamp)

to string

End date filter (ISO 8601 or unix timestamp)

include_leads boolean

Whether to include leads in the results

teammate_id string

Filter by assigned teammate UUID

automation_id string

Filter by automation UUID

product_id string

Filter by product UUID

affiliate_program_id string

Filter by affiliate program UUID

affiliate_program_partner_id string

Filter by affiliate program partner UUID

countries[] array of string

Filter by country codes

attributes[] array of string

Additional attributes to include

Responses

200 Customers listed successfully

Customers listed successfully

status integer

total_results integer

customers array of Customer

400 Validation or business-logic error. Possible `error_code` values:

401 Unauthorized – invalid or missing Bearer token

Create a customer

/customers/list

1 const response = await fetch("https://api.tamio.com/v2/customers/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/customers/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": 150,
  "customers": []
}

1	const response = await fetch("https://api.tamio.com/v2/customers/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/customers/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