CIcint
Intelligent Calendar

Suggest the required fielding time for a target group

Suggests the optimal number of days required to field a target group based on its specifications. You can use this endpoint to estimate fielding time before creating a target group. You'll need to provide details like the locale, price, length of interview (LOI), incidence rate (IR), and desired number of completes.

post/demand/intelligent-calendar/suggest-days

Request

Request body

localestring required

Unique text code of the locale.

collects_piiboolean

Indicates whether or not the target group collects Personally Identifiable Information (PII).

length_of_interviewinteger required

The expected median length of the interview, in minutes.

incidence_ratenumber required

The expected incidence rate (IR) of the target audience, expressed as a decimal (e.g., 0.5 for 50%). Must be greater than 0 and less than 1; the values 0 and 1 are rejected.

completesinteger required

The desired number of completed interviews.

Example request

{
  "locale": "eng_us",
  "collects_pii": true,
  "price": {
    "value": "2.7352",
    "currency_code": "USD"
  },
  "length_of_interview": 5,
  "incidence_rate": 0.5,
  "completes": 1000
}

Response

The suggested number of days was calculated successfully.

daysinteger

The suggested number of days required to field the target group.

Example response

{
  "days": 10
}

Changes

No recorded changes to this operation across all 1 revision of this API.