Skip to main content
Version: 2025-12-18

Suggests an optimal fielding time range for a locale

GET 
/demand/intelligent-calendar/suggest-time-range

Suggests an optimal time range to field a target group in a specific locale, taking into account local holidays and respondent activity patterns.

How to specify a time range:

  • To get a suggestion for a specific duration starting from now, provide the days parameter.
  • To get a suggestion within a specific date window, provide both the start and end parameters.

These options are mutually exclusive. A request that combines days with start or end, or that provides neither, returns a 400 error.

Request​

Responses​

The suggested time range was calculated successfully.

Response Headers
    traceparent

    The traceparent header carries the trace ID and parent span ID, as defined by the W3C Trace Context specification. It's used to trace a single request as it moves through multiple services.

    tracestate

    The tracestate header complements the traceparent header by carrying vendor-specific trace information. This allows different services to add their own data to a trace.