---
title: "Retrieve basic attributes and stats for a target group by ID"
method: GET
path: "/demand/target-groups/{target_group_id}/overview"
tags: ["Target Groups"]
---

# Retrieve basic attributes and stats for a target group by ID

`GET /demand/target-groups/{target_group_id}/overview`

## Request

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

Fetch a set of essential data points and statistical metrics related to a specific launched Target Group, such as its current status, progress, and other relevant details.

## Response `200`

A successful response returns requested Target Group attributes and statistics.

- TargetGroupOverviewByTargetGroupId: Basic attributes and statistics of a Target Group.
  - `account_id` integer, required: The account's unique identifier.
  - `project_id` string, required: The character string representing a unique project ID (ULID format).
  - `project_name` string, required: Name of the Project which contains the Target Group.
  - `target_group_name` string, required: Name 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.
  - `project_manager_id` string, uuid, required: A unique identifier for the user.
  - `progress` 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.
  - `pricing_model` 'rate_card' | 'dynamic', required: Denotes the pricing model setting for the target group based on the business unit.
  - `is_pricing_restricted` boolean, required: True when there are target group CPI restrictions in place from fielding assistant, otherwise false.
  - `current_cost_per_interview` MonetaryAmount, 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.
  - `average_cost_per_interview` MonetaryAmount: 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.
  - `current_cost` MonetaryAmount, 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.
  - `status` 'draft' | 'scheduled' | 'live' | 'paused' | 'completed' | 'archived', required: Target Group Status.
  - `country_code` string, required: String representing country code.
  - `language_code` string, required: String representing language code.
  - `conversion_rate` number, float, required: The current conversion rate of the target group.
  - `drop_off_rate` number, float, required: Current drop-off rate of the Target Group.
  - `incidence_rate` number, float, required: Current incidence rate of the Target Group.
  - `median_length_of_interview_seconds` integer, required: Current median length of interview of the Target Group in seconds.
  - `study_type_code` string: Uniquely identifies the Study Type that indicates the Target Group limits and purpose.
  - `target_group_customer_reference_number` string, nullable: A customer-provided reference number for the target group.
  - `created_at` string, date-time, required: Date and time when the target group was created (RFC3339 UTC format, 3 fractional digits).

## 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)