Send Gates
Beyond consent and suppression, several regulatory checks run at send time. Orbit groups them as send gates: each one can hold or drop a message or call before it dispatches. This page covers the gates you configure or query directly. All endpoints below are rooted athttps://api.orbit.devotel.io/api/v1/compliance.
Quiet hours
Quiet-hours rules block messages and calls that would land outside a recipient’s permitted local hours (e.g. the TCPA 8 am–9 pm window). Orbit resolves the recipient’s local time from their phone number’s region.GET /quiet-hours/preview tells you whether a send is allowed right
now, and when the next allowed time is — use it to schedule around the
window.
| Query param | Notes |
|---|---|
phone | E.164 (required). |
channel | sms, mms, whatsapp, rcs, viber, telegram, voice, email, etc. |
timezone_override | Optional IANA timezone if you already know it. |
DNC — Do Not Call
GET /dnc/check reports whether a number is on a Do-Not-Call list
before you dial or text it.
source indicates which layer flagged the number (your contact
DNC flag, the DNC list, the suppression list, or a consent opt-out).
DNC checking is gated behind the org setting
dnc_sync_enabled
(default off). While disabled the endpoint returns
403 DNC_SYNC_NOT_ENABLED. Orbit does not sync federal DNC feeds on
your behalf — federal_feeds_synced is always false.RND — Reassigned Numbers Database
US phone numbers get reassigned to new people. The FCC’s Reassigned Numbers Database lets you check whether a number was disconnected after the date you obtained consent — a “safe harbor” against texting or calling the wrong person.GET /rnd/check takes the phone and the consent_date
(YYYY-MM-DD):
status is no_data, active, or permanently_disconnected.
Gated behind rnd_scrub_enabled (default off); returns
403 RND_SCRUB_NOT_ENABLED while disabled.
RMD — Robocall Mitigation Database
US voice originators must file a Robocall Mitigation Database registration describing their STIR/SHAKEN status and mitigation plan. Orbit stores and tracks your filing.GET /rmd— read your registration plus arecertificationblock withrenewal_deadlineandaction_required.POST /rmd— create or update the filing.POST /rmd/submit→ statussubmitted.POST /rmd/certify→ statusactive.POST /rmd/remediation(with areason) → statusremediation_required.POST /rmd/resolve→ back toactive.POST /rmd/withdraw→ statuswithdrawn.
stir_shaken_status is complete, partial, or none. A
mitigation_plan is required unless status is complete. The
lifecycle is draft → submitted → active → remediation_required → active | withdrawn.
Emergency stop
The emergency stop is an org-wide kill switch that immediately halts all outbound SMS, MMS, voice, and dialer traffic — use it during an incident (a misconfigured campaign, a compromised key, a content mistake).GET /emergency-stop returns the current active flag plus
activated_at, activated_by, and reason. Activation and
deactivation require an admin/owner key.
Preference center
The preference center is a public, token-signed page where a contact manages their own channel opt-ins, message frequency, and (if enabled) requests data deletion — without logging in. Updates flow straight into consent, suppression, and the STOP-fence. Configure it once, then generate a per-contact link:POST /preference-center(admin/owner) — set branding, thechannelsoffered, frequency options, and the GDPR-delete toggle.GET /preference-center— read the current config.POST /preference-center/linkwith{ "contactId": "cnt_…" }— mint a signed link (HMAC-SHA256, 30-day TTL) to email or text to the contact.
GET/PUT /preferences/{token}) to view and update their
preferences. Opting out here records a consent revocation, adds a
suppression entry, and sets the STOP-fence; opting back in reverses
it. Requesting deletion files a DSAR on the contact’s behalf.
Country rules
GET /country-rules is the read-only regulatory reference behind
these gates — per country and channel it reports the allowed sender
types, whether Sender-ID registration is none / recommended /
required, STOP-keyword requirements, two-way support, DLR support,
and default throughput.
Related references
- Opt-Out & Suppression Lists — the suppression layer DNC and the preference center feed.
- Consent Management — the consent records updated by the preference center.
- Sender-ID Registration — the
registration
country-rulesreports as required. - API Reference → Compliance — full request/response schemas (regenerated from the live API).