Get Audience

Page last updated 12 June 2026

This endpoint retrieves a single audience for a specified project.

GETapi/management/projects/{projectId}/personalization/audiences/{audienceId}

Parameter

Name	Parameter type	Type	Description
projectId(required)	path	string	The project identifier found in the project overview screen of the management console.

Responses

HTTP status code	Reason	Model
401	Unauthorized	Error
404	Project not found	Error
422	Validation error(s)	Error
500	Internal server error	Error

Examples

Example Audience returned from the Personalization API

JSON

{
    "id": "AudienceB",
    "name": "Audience B",
    "description": "This is a test audience created in Postman",
    "conditions": {
        "and": [
            {
                "id": "testDelete",
                "type": "audience",
                "value": null
            },
            {
                "id": "signalTesting",
                "type": "signal",
                "value": null
            }
        ]
    },
    "version": {
        "createdBy": "Postman",
        "created": "2025-05-15T08:21:34.090322Z",
        "modifiedBy": "Postman",
        "modified": "2025-05-15T08:21:34.090322Z",
        "deletedBy": null,
        "deleted": null
    },
    "usageCount": 0
}

Remarks

The usageCount that is returned is the number of times the Audience is used/referenced by another Audience.

Still need help?

If you still need help after reading this article, don't hesitate to reach out to the Contensis community on Slack or raise a support ticket to get help from our team.

New support request