Get Distribution List
GET
/distributions
📦 Distributions API Documentation
Endpoint
Query Parameters
📑 Pagination
page number Page number (default: 1)limit number Number of items per page (default: 15, min: 1, max: 50)
🔍 Filtering
idnamecnamedomainstatusdomain_typecache_strategyorganization_idcertificate_idenable_sslis_redirect_http_to_httpsis_http2is_http3is_cname_validis_acme_challenge_validle_issuecreated_atupdated_atOperators
eq Equalsne Not equalslike Contains (case insensitive)not-like Does not containstarts-with Starts withends-with Ends withgt Greater thangte Greater than or equallt Less thanlte Less than or equalin In list (comma-separated)not-in Not in listnull Is nullnot-null Is not nullbetween Between two values (comma-separated)not-between Not between two values (comma-separated)Example Filters
filter[status][in]=active,disabled
filter[enable_ssl][eq]=true
filter[created_at][between]=2025-01-01,2025-08-01
↕ Sorting
sort Sort fields. Prefix with - for descending. Allowed:created_at, updated_at, name, status, domain_type,cache_strategy, domain, cnameExample Sorts
sort=name
sort=-created_at,name
📌 Example Requests
1. Prefix search + newest first
2. Status + type + alphabetical
3. Created date range
4. SSL-only
✅ Success Response
{
"success": true,
"count": 2,
"data": [
{
"id": "uuid",
"name": "cdn-example",
"status": "active",
"domain_type": "system",
"enable_ssl": true,
"created_at": "2025-02-01T12:00:00Z",
"updated_at": "2025-02-10T12:00:00Z"
}
]
}
❌ Error Response
{
"success": false,
"message": "Invalid filter query",
"errors": {
"filter": "Unsupported field or operator"
}
}
Request
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-staging.tenbyte.io/v1/distributions' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"created_at": "2025-08-18T06:04:15Z",
"description": "Seeded distribution 94399",
"updated_at": "2025-08-18T06:04:45Z",
"domain_type": "managed",
"name": "Distribution #94399",
"cname": "smartroute.tenbytecdn.com",
"domain": "tb-uhlpi0becq.tenbytecdn.com",
"status": "active",
"cache_strategy": "dynamic",
"organization_id": "dd48af2e-7eb5-46c6-b12d-82001e35a574",
"id": "000075b4-36ef-47da-9443-7d5742bc7a95",
"is_acme_challenge_valid": true,
"enable_ssl": true,
"le_issue": true,
"is_redirect_http_to_https": true,
"is_http2": true,
"is_cname_valid": false,
"is_http3": true
},
{
"created_at": "2025-08-18T06:04:15Z",
"description": "Seeded distribution 8999",
"updated_at": "2025-08-18T06:04:18Z",
"domain_type": "managed",
"name": "Distribution #8999",
"cname": "smartroute.tenbytecdn.com",
"domain": "tb-dkmbyy0d8d.tenbytecdn.com",
"status": "provisioning",
"cache_strategy": "custom",
"organization_id": "7cbdca03-5950-458b-9a97-005691cd64b4",
"id": "00011542-0b0e-4bf9-a369-8c1baeba8e32",
"is_acme_challenge_valid": false,
"enable_ssl": true,
"le_issue": true,
"is_redirect_http_to_https": true,
"is_http2": true,
"is_cname_valid": true,
"is_http3": true
},
{
"created_at": "2025-08-18T06:04:15Z",
"description": "Seeded distribution 9849",
"updated_at": "2025-08-18T06:04:18Z",
"domain_type": "custom",
"name": "Distribution #9849",
"cname": "smartroute.tenbytecdn.com",
"domain": "tb-hwdcfpsz3m.tenbytecdn.com",
"status": "disabled",
"cache_strategy": "live",
"organization_id": "66dfacfe-e0c7-4c62-b0d0-a853341df6ee",
"id": "0001559a-6255-4731-81f2-90e386026824",
"is_acme_challenge_valid": true,
"enable_ssl": true,
"le_issue": true,
"is_redirect_http_to_https": true,
"is_http2": true,
"is_cname_valid": true,
"is_http3": true
},
{
"created_at": "2025-08-18T06:04:15Z",
"description": "Seeded distribution 81829",
"updated_at": "2025-08-18T06:04:41Z",
"domain_type": "managed",
"name": "Distribution #81829",
"cname": "smartroute.tenbytecdn.com",
"domain": "tb-pm38xm08f8.tenbytecdn.com",
"status": "active",
"cache_strategy": "custom",
"organization_id": "18498b73-a1db-481c-8c23-262166b3a96d",
"id": "00016131-549e-4235-b325-d17a0e11f0c4",
"is_acme_challenge_valid": true,
"enable_ssl": true,
"le_issue": false,
"is_redirect_http_to_https": true,
"is_http2": true,
"is_cname_valid": false,
"is_http3": false
},
{
"created_at": "2025-08-18T06:04:15Z",
"description": "Seeded distribution 21994",
"updated_at": "2025-08-18T06:04:21Z",
"domain_type": "system",
"name": "Distribution #21994",
"cname": "smartroute.tenbytecdn.com",
"domain": "tb-oclcrivsom.tenbytecdn.com",
"status": "active",
"cache_strategy": "live",
"organization_id": "68fa2c9d-0e97-4a92-b773-6f6faf4bdb9f",
"id": "00021e15-95eb-4065-bec3-a8aef676fdde",
"is_acme_challenge_valid": false,
"enable_ssl": true,
"le_issue": true,
"is_redirect_http_to_https": true,
"is_http2": true,
"is_cname_valid": true,
"is_http3": true
}
],
"meta": {
"links": {
"self": "/distributions?limit=5&page=1",
"first": "/distributions?limit=5&page=1",
"next": "/distributions?limit=5&page=2",
"last": "/distributions?limit=5&page=20000"
},
"pagination": {
"page": 1,
"page_size": 5,
"total": 100000,
"total_pages": 20000
}
},
"message": "Request processed successfully.",
"success": true
}Modified at 2025-10-04 13:06:59