---
updatedAt: 2025-06-09T21:53:15.000Z
agentTools:
  projectIndex: https://developers.kayzen.io/llms.txt
---

# View Custom Audience

View the details of a Custom Audience. The details of an audience that is displayed include the name , id , app object details , details of the rules , conditions , operators and values assigned to these settings.

Example output :

```json Example of Custom Audience details:
{
  "id": 4191,
  "name": "MyCustomAudience",
  "frequency_value": 1,
  "frequency_operator": "equal_to",
  "mobile_object_id": 19,
  "mobile_object": {
    "id": 19,
    "type": "AppObject",
    "name": "Guns of Boom - Online PvP Action",
    "os_id": 11,
    "store_app_id": "com.gameinsight.gobandroid",
    "store_app_url": "https://play.google.com/store/apps/details?id=com.gameinsight.gobandroid",
    "icon_url": "https://lh3.googleusercontent.com/3Yq61TidZtP4AC5RlY4jJFrDLgdX-DNh5SzCraK7DNg9K25QvmW61Mtb6zWc1kqdNUk=s180",
    "rating": "4.56",
    "ad_domain": "https://gameinsight.helpshift.com/a/guns-of-boom/",
    "os": {
      "id": 11,
      "name": "Android",
      "created_at": "2016-06-23T11:16:36.000Z",
      "updated_at": "2016-06-30T07:55:00.000Z"
    },
    "tracking_partner_id": null,
    "tracking_partner_name": null,
    "primary_category_name": "Action",
    "categorization": {
      "category": "Core Games",
      "genre": "Shooter",
      "sub_genre": "Competitive Shooter"
    }
  },
  "audience_id": 21110,
  "last_success_at": "2023-10-19T04:46:32.000Z",
  "status": "successful",
  "description": "MyCustom Audience updated",
  "rules": [
    {
      "id": 5018,
      "recency_operator": "after",
      "recency_min": 5,
      "recency_max": null,
      "rules_operator": null,
      "conditions": [
        {
          "id": 6867,
          "operator": "equal",
          "value": "all_users",
          "combined_with_prev_condition_with": null,
          "drp_condition_type_id": 17
        }
      ]
    }
  ]
}
```

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "kayzen-oauth",
    "version": "1.3.1"
  },
  "servers": [
    {
      "url": "https://api.kayzen.io"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/custom_audiences/{id}": {
      "get": {
        "summary": "View Custom Audience",
        "description": "View the details of a Custom Audience. The details of an audience that is displayed include the name , id , app object details , details of the rules , conditions , operators and values assigned to these settings.",
        "operationId": "view-custom-audience",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Custom Audience ID",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"id\": 4445,\n  \"name\": \"Some custom audience\",\n  \"frequency_value\": null,\n  \"frequency_operator\": \"any\",\n  \"mobile_object_id\": 8119,\n  \"mobile_object\": {\n    \"id\": 8119,\n    \"type\": \"AppObject\",\n    \"name\": \"Keynote\",\n    \"os_id\": 12,\n    \"store_app_id\": \"361285480\",\n    \"store_app_url\": \"https://apps.apple.com/us/app/keynote/id361285480\",\n    \"icon_url\": \"https://is4-ssl.mzstatic.com/image/thumb/Purple122/v4/3f/be/a5/3fbea5ac-7a34-4e6c-0a05-ea1e41a3b458/AppIcon-0-1x_U007emarketing-0-0-0-7-0-0-0-0-0-85-220-0.png/512x512bb.jpg\",\n    \"rating\": \"3.48\",\n    \"ad_domain\": \"http://www.apple.com/keynote/\",\n    \"os\": {\n      \"id\": 12,\n      \"name\": \"iOS\",\n      \"created_at\": \"2016-06-23T11:16:36.000Z\",\n      \"updated_at\": \"2016-06-30T07:55:18.000Z\"\n    },\n    \"tracking_partner_id\": null,\n    \"tracking_partner_name\": null,\n    \"primary_category_name\": \"Productivity\",\n    \"categorization\": {\n      \"category\": \"Tools and Utility Apps\",\n      \"genre\": \"Tools\",\n      \"sub_genre\": \"Office\"\n    }\n  },\n  \"audience_id\": 1234,\n  \"last_success_at\": null,\n  \"status\": \"processing\",\n  \"description\": \"\",\n  \"rules\": [\n    {\n      \"id\": 1234,\n      \"recency_operator\": \"within\",\n      \"recency_min\": null,\n      \"recency_max\": 10,\n      \"rules_operator\": null,\n      \"conditions\": [\n        {\n          \"id\": 1235,\n          \"operator\": \"equal\",\n          \"value\": \"all_users\",\n          \"combined_with_prev_condition_with\": null,\n          \"drp_condition_type_id\": 17\n        }\n      ]\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "example": 4445,
                      "default": 0
                    },
                    "name": {
                      "type": "string",
                      "example": "Some custom audience"
                    },
                    "frequency_value": {},
                    "frequency_operator": {
                      "type": "string",
                      "example": "any"
                    },
                    "mobile_object_id": {
                      "type": "integer",
                      "example": 8119,
                      "default": 0
                    },
                    "mobile_object": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer",
                          "example": 8119,
                          "default": 0
                        },
                        "type": {
                          "type": "string",
                          "example": "AppObject"
                        },
                        "name": {
                          "type": "string",
                          "example": "Keynote"
                        },
                        "os_id": {
                          "type": "integer",
                          "example": 12,
                          "default": 0
                        },
                        "store_app_id": {
                          "type": "string",
                          "example": "361285480"
                        },
                        "store_app_url": {
                          "type": "string",
                          "example": "https://apps.apple.com/us/app/keynote/id361285480"
                        },
                        "icon_url": {
                          "type": "string",
                          "example": "https://is4-ssl.mzstatic.com/image/thumb/Purple122/v4/3f/be/a5/3fbea5ac-7a34-4e6c-0a05-ea1e41a3b458/AppIcon-0-1x_U007emarketing-0-0-0-7-0-0-0-0-0-85-220-0.png/512x512bb.jpg"
                        },
                        "rating": {
                          "type": "string",
                          "example": "3.48"
                        },
                        "ad_domain": {
                          "type": "string",
                          "example": "http://www.apple.com/keynote/"
                        },
                        "os": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "integer",
                              "example": 12,
                              "default": 0
                            },
                            "name": {
                              "type": "string",
                              "example": "iOS"
                            },
                            "created_at": {
                              "type": "string",
                              "example": "2016-06-23T11:16:36.000Z"
                            },
                            "updated_at": {
                              "type": "string",
                              "example": "2016-06-30T07:55:18.000Z"
                            }
                          }
                        },
                        "tracking_partner_id": {},
                        "tracking_partner_name": {},
                        "primary_category_name": {
                          "type": "string",
                          "example": "Productivity"
                        },
                        "categorization": {
                          "type": "object",
                          "properties": {
                            "category": {
                              "type": "string",
                              "example": "Tools and Utility Apps"
                            },
                            "genre": {
                              "type": "string",
                              "example": "Tools"
                            },
                            "sub_genre": {
                              "type": "string",
                              "example": "Office"
                            }
                          }
                        }
                      }
                    },
                    "audience_id": {
                      "type": "integer",
                      "example": 1234,
                      "default": 0
                    },
                    "last_success_at": {},
                    "status": {
                      "type": "string",
                      "example": "processing"
                    },
                    "description": {
                      "type": "string",
                      "example": ""
                    },
                    "rules": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 1234,
                            "default": 0
                          },
                          "recency_operator": {
                            "type": "string",
                            "example": "within"
                          },
                          "recency_min": {},
                          "recency_max": {
                            "type": "integer",
                            "example": 10,
                            "default": 0
                          },
                          "rules_operator": {},
                          "conditions": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "integer",
                                  "example": 1235,
                                  "default": 0
                                },
                                "operator": {
                                  "type": "string",
                                  "example": "equal"
                                },
                                "value": {
                                  "type": "string",
                                  "example": "all_users"
                                },
                                "combined_with_prev_condition_with": {},
                                "drp_condition_type_id": {
                                  "type": "integer",
                                  "example": 17,
                                  "default": 0
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```