Skip to main content
Version: 2025-05-27

Make a feasibility request

Let's create your first feasibility request using the endpoint Provides target group feasibility on draft mode.

This allows you to estimate the available audience, suggested pricing, and filling potential before launching your target group.

API endpoint​

POST /v1/demand/accounts/{account_id}/target-groups/calculate-feasibility

Path parameters​

You'll need to include the following parameters in the URL:

  • account_id (string, required): Your unique account identifier.
    • Example: 12345

Request header​

All requests to this endpoint require the following headers:

HeaderDescriptionExample
AuthorizationYour JWT token prefixed with Bearer.Bearer eyJhbGc...
Cint-API-VersionThe API version you are targeting.2025-05-27
Content-TypeMust be application/json.application/json
note

The idempotency-key header is not required for this endpoint.

Request body​

For the full list of request body parameters, see the Provides target group feasibility endpoint documentation.

note

Your Cint account is configured for one of two pricing models: dynamic pricing or rate card. This model is determined by your commercial agreement and affects how you'll build your request body. Choose the tab below that matches your account type to see the correct examples.

Example request body​

If you have a dynamic pricing account, you can optionally include the price object to suggest a starting Cost Per Interview (CPI). If you omit it, we'll provide an initial suggestion for you.

Example for a dynamic pricing account

{
    "business_unit_id": "<YOUR_BUSINESS_UNIT_ID>",
    "locale": "eng_gb",
    "collects_pii": false,
    "incidence_rate": "0.5",
    "length_of_interview": "20",
    "completes_goal": "40",
    "start_date": "2026-01-01T23:00:00.000Z",
    "end_date": "2026-05-01T23:00:00.000Z",
    "step_days": 0,
    "price": {
        "value": "2.7352",
        "currency_code": "EUR"
    },
    "profiles": [],
    "interlocked_profiles": []
}

Example request​

The following examples demonstrate how to send a request for feasibility. Remember to replace the placeholder values with your actual data and use the tab that matches your account's pricing model.

cURL command for a dynamic pricing account

curl -X POST \
'https://api.cint.com/v1/demand/accounts/{account_id}/projects/{project_id}/target-groups/calculate-feasibility' \
-H 'Content-Type: 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_gb",
    "collects_pii": false,
    "incidence_rate": "0.5",
    "length_of_interview": "20",
    "completes_goal": "40",
    "start_date": "2026-01-01T23:00:00.000Z",
    "end_date": "2026-05-01T23:00:00.000Z",
    "step_days": 0,
    "price": {
        "value": "2.7352",
        "currency_code": "EUR"
    },
    "profiles": [],
    "interlocked_profiles": []
}'

Example responses​

A successful request returns an HTTP 200 OK status code. The response body will vary depending on your account type.

You'll receive a response with suggested price ranges and filling goals.

Example response for a dynamic pricing customer

{
    "suggested_price": {
        "value": "0.322062341",
        "currency_code": "USD"
    },
    "suggested_price_range": {
        "min": {
            "value": "0.250000000",
            "currency_code": "USD"
        },
        "max": {
            "value": "0.322062341",
            "currency_code": "USD"
        }
    },
    "suggested_filling_goal_range": {
        "min": 40,
        "max": 40
    }
}

Congratulations!​

You have successfully created your first feasibility request.

Next steps​

Now that you have made your first feasibility call and understand the potential reach and cost for your target, let’s launch your first target group!