# POST /{environment}/targeting/audiences/requests
> Current Froomle documentation ยท [View canonical page](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html)
## Description
Request an audience for a promotion.
## Parameters
| Type | Name | Description | Schema |
| --- | --- | --- | --- |
| **Path** | **environment**
_required_ | The environment for which a request is made. | string |
| **Body** | **body**
_required_ | | [AudienceTargetingRequest](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html#_audiencetargetingrequest) |
## Responses
| HTTP Code | Description | Schema |
| --- | --- | --- |
| **200** | Audience targeting request was successful. | [AudienceTargetingResponse](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html#_audiencetargetingresponse) |
| **400** | Audience targeting request is malformed or contains invalid values. | [ErrorBody](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html#_errorbody) |
| **401** | Not authorized to make an audience targeting request. | [ErrorBody](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html#_errorbody) |
## Consumes
- `application/json`
## Produces
- `application/json`
## Example HTTP request
### Request body
```json
{
"audience" : {
"audience_configuration_id" : "some_configuration_id",
"audience_id" : "dhoghesjwgotuy39",
"audience_name" : "Don't miss this!",
"audience_size" : 100,
"integration_type" : "push_notification_app",
"limit" : 3,
"promotion" : [ {
"id" : "item_1",
"item_type" : "article"
}, {
"id" : "item_2",
"item_type" : "article"
} ]
}
}
```
## Example HTTP response
### Response 200
```json
{
"audience" : {
"audience_configuration_id" : "some_configuration_id",
"audience_id" : "dhoghesjwgotuy39",
"audience_name" : "Don't miss this!",
"audience_size" : 100,
"integration_type" : "push_notification_app",
"limit" : 3,
"users" : [ {
"id" : "user_1",
"user_type" : "login"
}, {
"id" : "user_2",
"user_type" : "login"
}, {
"id" : "user_3",
"user_type" : "login"
} ]
}
}
```
* * *
### AudienceTargetingRequest
Request an audience for a promotion.
| Name | Description | Schema |
| --- | --- | --- |
| **audience**
_required_ | Audience object in request. | [audience](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html#_audiencetargetingrequest_audience) |
**audience**
| Name | Description | Schema |
| --- | --- | --- |
| **audience\_configuration\_id**
_required_ | Configuration ID to pose constraints upon audience. | string |
| **audience\_id**
_required_ | A unique identifier for the audience request which is to be supplied with each logged event. | string |
| **audience\_name**
_required_ | Name of the audience, to be passed in tracking events later. | string |
| **audience\_size**
_required_ | Total size of the audience requested. Use limit for pagination. | integer |
| **integration\_type**
_required_ | Name of the type of integration. | string |
| **limit**
_optional_ | Number of Users to be returned | integer |
| **partition\_audience\_by\_item**
_optional_ | If true, each user in the response is assigned to a particular item in the promotion.
**Default** : `false` | boolean |
| **promotion**
_required_ | | [Promotion](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html#_promotion) |
### AudienceTargetingResponse
Response containing an audience for a promotion.
| Name | Description | Schema |
| --- | --- | --- |
| **audience**
_required_ | Audience object in response. | [audience](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html#_audiencetargetingresponse_audience) |
**audience**
| Name | Description | Schema |
| --- | --- | --- |
| **audience\_id**
_required_ | A unique identifier for the audience request which is to be supplied with each logged event. | string |
| **audience\_name**
_required_ | Name of the audience, to be passed in tracking events later. | string |
| **audience\_size**
_required_ | Total size of the audience requested. Use limit for pagination. | integer |
| **integration\_type**
_required_ | Name of the type of integration. | string |
| **limit**
_required_ | Number of Users to be returned | integer |
| **users**
_required_ | List containing User-objects. | < [User](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html#_user) > array |
### Promotion
A collection of items we wish to promote to an audience.
_Type_ : < [Item](https://docs.froomle.com/froomle-doc-main/v2/api_reference/audience/operations/get_audience.html#_item) > array
### Item
An Item object.
| Name | Description | Schema |
| --- | --- | --- |
| **id**
_required_ | Unique identifier of the item. | string |
| **item\_type**
_required_ | The type of the item. | string |
### User
A User object.
| Name | Description | Schema |
| --- | --- | --- |
| **id**
_required_ | Unique identifier of the user. | string |
| **user\_type**
_required_ | Type of user identifier. Currently one of user\_id or device\_id. | string |
### ErrorBody
Error message.
| Name | Description | Schema |
| --- | --- | --- |
| **detail**
_optional_ | Detailed description of the error. | string |
| **status**
_optional_ | Status-code for the error. | integer |
| **title**
_optional_ | Name of the error. | string |
| **type**
_optional_ | Type of the exception thrown. | string |