---
title: "List target groups for a project"
method: GET
path: "/demand/accounts/{account_id}/projects/{project_id}/target-groups"
tags: ["Target Groups"]
---

# List target groups for a project

`GET /demand/accounts/{account_id}/projects/{project_id}/target-groups`

## Request

- Base URL: `https://api.cint.com/v1`
- URL: `https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cint/apis/demand-api/docs/demand/accounts/:account_id/projects/:project_id/target-groups/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch a paginated list of essential data points and statistical metrics related to Target Groups of a single project, such as current status, progress, and other relevant details, based on filter criteria such as language, country, name, etc.

## Query parameters

- `end_before` string
- `start_after` string
- `page_size` integer
- `exclusion_status` boolean
- `name` string
- `search_string` string
- `human_readable_ids` TargetGroupHumanReadableID[]
- `target_group_customer_reference_numbers` TargetGroupCustomerReferenceNumber[]
- `status` TargetGroupStatus[]
- `country` string[]
- `language` string[]
- `project_manager_id` string, uuid: A unique identifier for the user.

## Response `200`

A successful response returns a paginated list of matching Target Groups along with details such as attributes and metrics.

- TargetGroupsList: Paginated list of Target Groups.
  - `url` string, required: URL which produced this list (without query parameters).
  - `has_more` boolean, required: If there are further results to be shown using the returned next cursor or previous cursor, this will be true, otherwise false.
  - `next_cursor` string, nullable: An identifier for pagination that indicates there are more items available. When present, use this value to retrieve the next page of results.
  - `target_groups` TargetGroupsListItem[], required: Array of Target Group list items, representing the results of the query.
    - `id` string, required: ULID identifier of the Target Group.
    - `human_readable_id` string: The target group's human-readable ID. This ID is unique within the scope of an account.
    - `name` string, required: Name of the Target Group.
    - `highlighted_name` string: The name of the target group, with parts that matched the search string being highlighted between HTML emphasis tags. If there was no search string, or the search string matched this target group based on the identifier (and not based on the name), this property will be omitted.
    - `project_manager_id` string, uuid, required: Project manager ID.
    - `exclusion_enabled` boolean: Whether or not the given target groups exclusion status within the given exclusion policy is set to active
    - `locale` string, required: Unique text code of the locale.
    - `status` 'draft' | 'scheduled' | 'live' | 'paused' | 'completed' | 'archived', required: Target Group Status.
    - `created_at` string, date-time, required: The timestamp the Target Group was created at (RFC3339 UTC format, 3 fractional digits).
    - `updated_at` string, date-time: The timestamp the Target Group was updated at (RFC3339 UTC format, 3 fractional digits).
    - `statistics` TargetGroupStatistics, required: Statistics relevant for the Target Group, each statistic might include one or more issue descriptors.
      - `progress` object, required
        - `value` TargetGroupProgress, required: Measurement of the type and progress of the Target Group. A Target Group is considered fulfilled when the `filling_goal` has been reached.
          - `current_completes` integer, required: Completes collected in the Target Group so far.
          - `current_prescreens` integer, required: Prescreens collected in the Target Group so far.
          - `filling_goal` integer, required: The limit of completes or prescreens to be collected in the Target Group.
          - `filling_strategy` 'automated' | 'prescreens' | 'completes', required: Target group filling strategy.
        - `issues` TargetGroupStatisticIssue[], required: List of issues.
          - `reason` TargetGroupStatisticIssueReason
            - `code` string, required
            - `description` string, required
          - `issue_type` 'warning' | 'error', required: The type of issue.
          - `suggestions` TargetGroupStatisticsIssuesSuggestion[], required: List of suggestions how to remedy the issues on the statistic.
            - `code` string, required
            - `description` string, required
      - `last_complete_date` object
        - `value` string, date-time, required: The timestamp the Target Groups latest complete was received (RFC3339 UTC format, 3 fractional digits).
        - `issues` TargetGroupStatisticIssue[], required: List of issues.
          - `reason` TargetGroupStatisticIssueReason
            - `code` string, required
            - `description` string, required
          - `issue_type` 'warning' | 'error', required: The type of issue.
          - `suggestions` TargetGroupStatisticsIssuesSuggestion[], required: List of suggestions how to remedy the issues on the statistic.
            - `code` string, required
            - `description` string, required
      - `earnings_per_click` object
        - `value` EarningsPerClick, required: Represents a monetary value, including the amount and its currency.
          - `value` string: A decimal encapsulated in a string representing the value in the denomination indicated by the code.
          - `currency_code` string: The three-letter ISO 4217 currency code, in uppercase. The code must correspond to a currency supported by Cint Exchange.
          - `currency_scale` integer, nullable: The number of digits after the decimal separator, as defined by ISO 4217.
        - `issues` TargetGroupStatisticIssue[], required: List of issues.
          - `reason` TargetGroupStatisticIssueReason
            - `code` string, required
            - `description` string, required
          - `issue_type` 'warning' | 'error', required: The type of issue.
          - `suggestions` TargetGroupStatisticsIssuesSuggestion[], required: List of suggestions how to remedy the issues on the statistic.
            - `code` string, required
            - `description` string, required
      - `earnings_per_click_per_minute` object
        - `value` EarningsPerClickPerMinute, required: Represents a monetary value, including the amount and its currency.
          - `value` string: A decimal encapsulated in a string representing the value in the denomination indicated by the code.
          - `currency_code` string: The three-letter ISO 4217 currency code, in uppercase. The code must correspond to a currency supported by Cint Exchange.
          - `currency_scale` integer, nullable: The number of digits after the decimal separator, as defined by ISO 4217.
        - `issues` TargetGroupStatisticIssue[], required: List of issues.
          - `reason` TargetGroupStatisticIssueReason
            - `code` string, required
            - `description` string, required
          - `issue_type` 'warning' | 'error', required: The type of issue.
          - `suggestions` TargetGroupStatisticsIssuesSuggestion[], required: List of suggestions how to remedy the issues on the statistic.
            - `code` string, required
            - `description` string, required
      - `average_cost_per_interview` object
        - `value` AverageCostPerInterview, required: Represents a monetary value, including the amount and its currency.
          - `value` string: A decimal encapsulated in a string representing the value in the denomination indicated by the code.
          - `currency_code` string: The three-letter ISO 4217 currency code, in uppercase. The code must correspond to a currency supported by Cint Exchange.
          - `currency_scale` integer, nullable: The number of digits after the decimal separator, as defined by ISO 4217.
        - `issues` TargetGroupStatisticIssue[], required: List of issues.
          - `reason` TargetGroupStatisticIssueReason
            - `code` string, required
            - `description` string, required
          - `issue_type` 'warning' | 'error', required: The type of issue.
          - `suggestions` TargetGroupStatisticsIssuesSuggestion[], required: List of suggestions how to remedy the issues on the statistic.
            - `code` string, required
            - `description` string, required
      - `median_length_of_interview_seconds` object
        - `value` integer, required: Current median length of interview of the Target Group in seconds.
        - `issues` TargetGroupStatisticIssue[], required: List of issues.
          - `reason` TargetGroupStatisticIssueReason
            - `code` string, required
            - `description` string, required
          - `issue_type` 'warning' | 'error', required: The type of issue.
          - `suggestions` TargetGroupStatisticsIssuesSuggestion[], required: List of suggestions how to remedy the issues on the statistic.
            - `code` string, required
            - `description` string, required
      - `incidence_rate` object
        - `value` number, float, required: Current incidence rate of the Target Group.
        - `issues` TargetGroupStatisticIssue[], required: List of issues.
          - `reason` TargetGroupStatisticIssueReason
            - `code` string, required
            - `description` string, required
          - `issue_type` 'warning' | 'error', required: The type of issue.
          - `suggestions` TargetGroupStatisticsIssuesSuggestion[], required: List of suggestions how to remedy the issues on the statistic.
            - `code` string, required
            - `description` string, required
      - `drop_off_rate` object
        - `value` number, float, required: Current drop-off rate of the Target Group.
        - `issues` TargetGroupStatisticIssue[], required: List of issues.
          - `reason` TargetGroupStatisticIssueReason
            - `code` string, required
            - `description` string, required
          - `issue_type` 'warning' | 'error', required: The type of issue.
          - `suggestions` TargetGroupStatisticsIssuesSuggestion[], required: List of suggestions how to remedy the issues on the statistic.
            - `code` string, required
            - `description` string, required
      - `conversion_rate` object
        - `value` number, float, required: The current conversion rate of the target group.
        - `issues` TargetGroupStatisticIssue[], required: List of issues.
          - `reason` TargetGroupStatisticIssueReason
            - `code` string, required
            - `description` string, required
          - `issue_type` 'warning' | 'error', required: The type of issue.
          - `suggestions` TargetGroupStatisticsIssuesSuggestion[], required: List of suggestions how to remedy the issues on the statistic.
            - `code` string, required
            - `description` string, required
    - `target_group_customer_reference_number` string, nullable: A customer-provided reference number for the target group.

## Other responses

- `400`: A request is not valid and can't be processed.
- `401`: A request is unauthorized.
- `403`: A requested is forbidden.
- `404`: A requested resource isn't found.
- `500`: A request failed due to an internal error.

---

[API](https://skmtc.dev/cint/apis/demand-api.md) - [All operations](https://skmtc.dev/cint/apis/demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cint/apis/demand-api/revisions/077a4bdda5cb?raw)