List all affiliate partners

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

Returns a paginated list of affiliate partners. Supports filtering by status, country, affiliate program, automation, date range, and text search.

Query Parameters

page integer

Page number for pagination (1-based).

per_page integer

Number of affiliate partners to return per page.

order string

Sort order for the results.

ascdesc

filter string

Text filter to search affiliate partners by name or email.

sort_by string

Field to sort results by.

nameemailcountrycreated_at

from object

Start date filter (ISO 8601 string or Unix timestamp).

to object

End date filter (ISO 8601 string or Unix timestamp).

affiliate_program_id string

Filter by a specific affiliate program UUID.

automation_id string

Filter by a specific automation UUID.

status string

Filter by application status.

approvedpending

countries array of string

Array of country codes to filter by (1–120 unique values).

Responses

200 Paginated list of affiliate partners.

Paginated list of affiliate partners.

status integer

total_results integer

Total number of matching affiliate partners.

affiliates array of Affiliate

400 Validation or business logic error. Possible causes:

Validation or business logic error. Possible causes:

page or per_page is not an integer or exceeds maximum
order is not one of asc, desc
sort_by is not one of name, email, country, created_at
status is not one of approved, pending
filter exceeds 120 characters
from / to is not a valid date format
affiliate_program_id or automation_id is not a valid UUID
countries is empty, exceeds 120 items, has duplicates, or contains invalid codes
Additional properties present

Error codes:

Code	Description
1002	Affiliate program or automation not found

status integer

error string

error_code integer

401 Missing or invalid Bearer token.

Retrieve an affiliate partner

/affiliates/list

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

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