Skip to main content
POST
Returns a boolean true or false if a phone number call is permitted on a provided datetime. If the call is permitted, also provides number of seconds remaining in legal calling window.

Request Parameters

The CallProposedDateTimeInUTC parameter is optional. If omitted or set to null, the API will use the current UTC time, making it easy to check if a call is legal right now without having to calculate the current time yourself.

How calling windows are determined

IsCallPermitted is true when the proposed time falls inside one of the legal calling windows for the called party’s local time. Windows are resolved in priority order:
  1. Project-level override — calling-hour rules you’ve configured against your DNCProjId for a given state in the DNCScrub Portal. Use this when your brand wants stricter rules than law requires.
  2. State law overlay — state-specific telephone solicitation curfews tracked by Contact Center Compliance. For example, Alabama is 8 AM – 8 PM with no Sunday calls; California is 9 AM – 9 PM all 7 days; Florida is 8 AM – 8 PM. State laws are maintained by our in-house compliance counsel and updated as legislation changes — no client-side change is required.
  3. Federal baseline — applied when no state overlay exists. US numbers default to FCC TCPA: 8 AM – 9 PM, all 7 days, called-party local time. Canadian numbers default to CRTC: 9 AM – 9:30 PM weekdays, 10 AM – 6 PM weekends.
A state with no Sunday calling allowed (e.g. AL/LA/MS) returns IsCallPermitted = false for any Sunday timestamp.
The response reflects residential telephone solicitation curfews. B2B calls have different rules in some states (full exemptions, narrower windows, etc.) — this API does not apply B2B exemptions. If your call list is exclusively to businesses, apply that logic on your side.

Response Fields

Every input phone produces exactly one row in the response. Inspect Status to decide how to handle each row.

Status Values

We deliberately do not guess a timezone for UNKNOWN_NXX numbers: a wrong “legal to call” answer driven by a guessed timezone is TCPA exposure, and silently approving calls to nonworking numbers would hide data quality problems on your side.
Per-row Status replaces the older behavior where a single bad phone caused the entire batch to return HTTP 400. The endpoint now returns 200 with one row per input phone; inspect Status to decide which rows are usable. HTTP 400 is still returned for batch-level errors (missing body, empty list, more than 1000 phones).

Headers

loginId
string

LoginId (aka APIKey)

Body

Response

Success

Response
object[] | null