Skip to main content
Version: 2025-05-27

How to get feasibility estimates for the target group you would like to launch

Feasibility requests let you simulate a target group launch based on your targeting criteria. This provides insights into your potential audience reach and costs to help you refine your project plan and budget.

Before you can get the feasibility for a target group, you'll need to have:

  • Your unique account ID: {account_id} path parameter
  • Your API authentication token (JWT): <YOUR_JWT_TOKEN>
  • Your business unit ID: <YOUR_BUSINESS_UNIT_ID>

For a deeper understanding of how our feasibility calculations work, you can refer to our guide on how Cint's feasibility works.

See the feasibility API reference documentation for further references.

Step 1: Prepare your feasibility request body​

First, you'll construct the JSON payload that defines the parameters for your feasibility query. This includes details like your desired locale, expected incidence rate, defined profile, and completes goal, along with pricing information.

For the direct cURL examples, skip to Step 2: Make the feasibility request.

Fields to consider:

  • business_unit_id (string, required): This is your unique business unit identifier.
  • locale (string, required): The target locale (e.g., "eng_us"). See our list of supported locales for all valid codes.
  • collects_pii (boolean, required): You should set this to true if your survey collects personally identifiable information, and false otherwise.
  • incidence_rate (number, required): Your expected survey incidence rate (IR) as a decimal (e.g., 0.5 for 50%).
  • length_of_interview (number, required): Your estimated length of interview (LOI) in minutes (e.g., 20).
  • filling_goal (number, required): Your desired number of completes (e.g., 40).
  • start_date (string, required): The start date and time of fieldwork in RFC3339 UTC format.
  • end_date (string, required): The end date and time of fieldwork in RFC3339 UTC format.
  • price (object, conditionally required): The proposed cost per interview. This is specific to business units associated with the dynamic pricing model. Find out more about feasibility for dynamic pricing here. Parameter is ignored if using rate card pricing model.
  • value (string, required): The monetary value.
  • currency_code (string, required): The ISO 4217 currency code (e.g., "USD").
  • rate_card_price_boost (object, conditionally optional): An optional amount to add to your rate card price. This is specific to business units associated with rate card pricing model. Find out more about feasibility for rate card pricing here. Parameter is ignored if using dynamic pricing model.
  • value (string, required): The monetary value.
  • currency_code (string, required): The ISO 4217 currency code.
  • profiles (array of objects, required): An array of profile objects defining your targeting criteria.
  • object (string, required): The profile object type (e.g., "regular").
  • quotas_enabled (boolean, required): Set to true if quotas are enabled for this profile, otherwise false.
  • targets (array of objects, required): An array of target objects defining specific targeting conditions and quotas.
  • conditions (array of objects, required): An array of condition objects that specify the targeting criteria.
  • quota (object, required): The quota settings for this target.
  • quota_percentage (number, required): The percentage of the total filling goal allocated to this target (e.g., 50 for 50%).
  • allocations (object, optional): Allows you to specify allocations for different supplier sources. If omitted, the system will use default allocation settings.
  • open_exchange_allocations (object, required): Defines allocations for the Open Exchange supply source.
  • private_exchange_allocations (object, optional): Defines allocations for the Open Exchange supply source.

Step 2: Make the feasibility request​

Next, you'll send your prepared request body to the feasibility endpoint.

  • API endpoint: POST https://api.cint.com/v1/demand/accounts/{account_id}/target-groups/calculate-feasibility

Reminder, you will need the following to make the request:

  • Your unique account ID: {account_id} path parameter
  • Your API authentication token (JWT): <YOUR_JWT_TOKEN>
  • Your business unit ID: <YOUR_BUSINESS_UNIT_ID>
  • Cint API Version: 2025-05-27

Example cURL request

  curl -L 'https://api.cint.com/v1/demand/accounts/{account_id}/target-groups/calculate-feasibility' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <YOUR_JWT_TOKEN>' \
  -H 'Cint-API-Version: 2025-05-27' \
  -d '{
    "business_unit_id": "<YOUR_BUSINESS_UNIT_ID>",
    "locale": "eng_us",
    "incidence_rate": 0.25,
    "length_of_interview": 15,
    "filling_goal": 500,
    "start_date": "2026-08-01T10:00:00.000Z",
    "end_date": "2026-08-31T10:00:00.000Z",
    "rate_card_price_boost": {
      "value": "2.00",
      "currency_code": "USD"
    },
    "profiles": [
      {
        "question_id": 42,
        "conditions": {
          "object": "range_conditions_details",
          "data": [
            {
              "min": 18,
              "max": 24
            },
            {
              "min": 25,
              "max": 35
            },
            {
              "min": 36,
              "max": 45
            }
          ]
        },
        "quotas": {
          "ungrouped": [
            {
              "index": 0,
              "quota_percentage": 100
            },
            {
              "index": 1,
              "quota_percentage": 25
            }
          ],
          "grouped": [
            {
              "indexes": [
                1,
                2
              ],
              "quota_percentage": 75
            }
          ]
        }
      }
    ],
    "allocations": {}
  }'
note

Remember to replace all bracketed placeholders (e.g., <YOUR_BUSINESS_UNIT_ID>, {account_id}) with your actual values.

Step 3: Interpret the feasibility response​

A successful request will return an HTTP 200 OK status code and a JSON object containing the feasibility estimate.

Example successful response

  {
    "suggested_price": {
      "value": "1.25",
      "currency_code": "USD",
      "currency_scale": 2
    },
    "suggested_filling_goal_range": {
      "min": 450,
      "max": 525
    },
    "profiles": [
      {
        "object": "regular",
        "targets": [
          {
            "conditions": [
              {
                "object": "range",
                "question_id": 12413,
                "min": 18,
                "max": 34
              }
            ],
            "quota": {
              "min_completes": {
                "projected_filling_goal": 225
              },
              "max_completes": {
                "projected_filling_goal": 262
              }
            }
          }
        ]
      }
    ],
    "allocations": {
      "open_exchange_allocations": {
        "min_completes": 450,
        "max_completes": 525,
        "groups": []
      }
    }
  }

Response field descriptions:

  • suggested_price (object): The recommended cost per interview (CPI) based on your query.
    • value (string): The monetary value.
    • currency_code (string): The ISO 4217 currency code.
    • currency_scale (integer): The number of decimal places for the currency.
  • suggested_filling_goal_range (object): A range that indicates the minimum and maximum number of completes you can achieve.
    • min (integer): The minimum achievable completes.
    • max (integer): The maximum achievable completes.
  • profiles (array of objects): An array reflecting the profile targets and their respective quotas as defined in your request. Refer to Cint Profile Question Library for valid profile questions and options.
    • object (string): The profile object type.
    • targets (array of objects): An array of target objects defining specific targeting conditions and quotas.
      • conditions (array of objects): An array of condition objects that specify the targeting criteria.
      • quota (object): The quota settings for this target.
        • min_completes (object): The minimum completes achievable for this target.
          • projected_filling_goal (integer): The projected minimum completes goal.
        • max_completes (object): The maximum completes achievable for this target.
          • projected_filling_goal (integer): The projected maximum completes goal.
  • allocations (object, optional): Allows you to specify allocations for different supplier sources, if available. This will be null if it's not applicable or not provided.
    • open_exchange_allocations (object): Details about the Open Exchange allocations.
    • min_completes (integer): The minimum number of completes allocated from Open Exchange.
    • max_completes (integer): The maximum number of completes allocated from Open Exchange.
    • groups (array of objects): An array of group allocation objects for more granular control. This will be an empty array if no specific groups were defined.

Troubleshooting common issues​

  • HTTP 400 Bad Request:
    • Check that all required fields in the request body are present and correctly formatted (e.g., dates are RFC3339 UTC).
    • Make sure your incidence_rate is between 0.01 and 1.00.
    • Verify that the locale is valid and supported.
  • HTTP 401 Unauthorized: Your JWT token is missing or invalid. You can refer to our authentication guide for more information.
  • HTTP 403 Forbidden: Your JWT token is valid, but it doesn’t have the necessary permissions for this operation.
  • HTTP 404 Not Found: The account_id in the URL path is incorrect or doesn’t exist.
  • Unrealistic feasibility results (e.g., 0 completes):
    • Review your profiles array. Are the question IDs and options valid? Are the quotas realistic for the target demographic?
    • Check your incidence_rate and length_of_interview. Very low IRs or very long LOIs can severely impact feasibility.
    • Make sure your start_date and end_date dates define a sufficient fielding window.
  • Placeholders: Make sure you've replaced all placeholder values (e.g., <YOUR_BUSINESS_UNIT_ID>, {account_id}) with your actual data before making the request.