Parameters

page
number
Description
Page number for pagination. Default is 1.
per_page
number
Description
Number of records per page (1-100). Default is 30.
audience_type
string
Description
Filter by audience type (`user` or `account`).
status
string
Description
Filter by status: `draft`, `active`, or `inactive`.
sort
string
Description
Sort order: `newest_first`, `oldest_first`, `name_asc`, or `name_desc`.
GET/v1/audiences
curl https://api.tradly.app/v1/audiences \
  -H "Authorization: Bearer YOUR_PUBLISHABLE_OR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
RESPONSE
{
  "status": true,
  "data": {
    "total_records": 2,
    "page": 1,
    "audiences": [
      {
        "id": 1,
        "name": "High-Value Buyers",
        "description": "Buyers with gold tier or above",
        "audience_type": "user",
        "status": "active",
        "filters": [
          {
            "dimension": "user_type",
            "operator": "includes",
            "value": "buyer"
          }
        ],
        "estimated_count": 142,
        "last_calculated_at": 1723068000,
        "created_by": 10,
        "updated_by": 10,
        "created_at": 1723068000,
        "updated_at": 1723068000
      },
      {
        "id": 2,
        "name": "Verified Merchant Accounts",
        "description": "Accounts with active merchant status",
        "audience_type": "account",
        "status": "active",
        "filters": [
          {
            "dimension": "metadata",
            "path": "verified",
            "operator": "equals",
            "value": true
          }
        ],
        "estimated_count": 35,
        "last_calculated_at": 1723068000,
        "created_by": 10,
        "updated_by": 10,
        "created_at": 1723068000,
        "updated_at": 1723068000
      }
    ]
  }
}