Retrieve an affiliate program

GET https://api.tamio.com/v2/affiliate-programs/retrieve/{uuid}

Retrieves a single affiliate program by its UUID. Returns the full program object including commission structure, multilingual content, and merchant-only data.

Path Parameters

uuid string*

UUID of the affiliate program to retrieve.

Responses

200 Program retrieved successfully

Program retrieved successfully

status integer

program AffiliateProgram

400 Validation or business logic error. Returned when:

Validation or business logic error. Returned when:

uuid is missing or not a valid UUID format

Error codes:

Code	Description
1002	Affiliate program not found

status integer

error string

error_code integer

401 Missing or invalid API key

List all affiliate programs

Create an affiliate program

/affiliate-programs/retrieve/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/affiliate-programs/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/affiliate-programs/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,
  "program": {
    "object": "affiliate_program",
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "label": "Premium Affiliate Program",
    "created_at": 1709500800,
    "currency": "EUR",
    "commission_amount": 500,
    "commission_percent": 0.1,
    "description": "string",
    "payout_delay": 30,
    "subscription_commission_type": "once",
    "destinations": [
      "worldwide"
    ],
    "payments": [
      "stripe"
    ],
    "payment_count": 0,
    "approved": true,
    "auto_approve": false,
    "is_active": true,
    "products": [],
    "languages": {},
    "domain": {},
    "signup_url": "string",
    "is_listed": false,
    "banners": [],
    "affiliates": 0,
    "sales": 0,
    "javascript_url": "string",
    "is_public": false,
    "cookie_expiry": 30,
    "first_takes_all": "enabled",
    "affiliate_notifications": false
  }
}

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