Get Audiences (List)

Retrieve a paginated list of all audience segments associated with your account.

Endpoint: GET /v1/audiences?page=1&pageSize=10

Request Example:

{  
  "page": 1,  
  "pageSize": 10  
}

page and pageSize are optional parameters.

Response (Success):

JSON

{  
  "audiences": [  
    {  
      "accountId": 2222,  
      "advertiserIds": 123123,  
      "dataCount": 1050,  
      "description": "Description to Described Audience",  
      "externalAudienceId": "ex123123",  
      "name": "SegmentName",  
      "status": "ACTIVE", 
      "viantSegmentId": "fpsegm123123123",
      "ttl": 345600 
    },  
    {
      "accountId": 2222,
      "advertiserIds": 123124,
      "dataCount": 1500,
      "description": "Description to Described Audience",
      "externalAudienceId": "ex123124",
      "name": "SegmentName2",
      "status": "ARCHIVED",
      "viantSegmentId": "fpsegm123123124",
      "ttl": 345600
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 5
  }
}

Failure Examples:

JSON

{  
  "error": "Unauthorized - Invalid JWT"  
}

JSON

{  
  "error": "Internal server error"  
}