POST /v1/revoke

When a consumer says “stop,” “don’t call me,” or expresses any opt-out intent, call this endpoint immediately. eConsent revokes all active consents for this consumer and calling entity, propagates the revocation across the network, and starts the FCC’s 10-business-day honor window.

This endpoint is always free. We never charge for compliance.

Request

POST https://voice.econsent.org/v1/revoke
Authorization: Bearer ec_voice_YOUR_KEY
Content-Type: application/json

Body

{
  "phone": "+15551234567",
  "calling_entity": "Acme Insurance LLC",
  "trigger": "verbal_stop_during_call",
  "captured_at": "2026-04-10T15:43:10Z",
  "audio_segment_url": "https://storage.yourplatform.com/segments/stop.wav",
  "transcript": "Stop calling me",
  "scope": "entity_only"
}

Field	Type	Required	Description
phone	string	Yes	Consumer phone in E.164
calling_entity	string	Yes	Legal entity to revoke consent for
trigger	string	Yes	verbal_stop_during_call, dtmf_opt_out, sms_stop, web_form, manual
captured_at	string	No	ISO 8601 timestamp (defaults to now)
audio_segment_url	string	No	URL to the audio segment where the opt-out was expressed
transcript	string	No	What the consumer said
scope	string	No	entity_only (default) or all (network-wide revocation)

Response

{
  "revoked": true,
  "revocation_id": "rev_lx8kb1c2d3e4f5g6",
  "honor_by_date": "2026-04-24T15:43:10Z",
  "propagated_to_network": true,
  "evidence_url": "https://verify.econsent.org/r/rev_lx8kb1c2d3e4f5g6",
  "future_calls_blocked": true
}

Tip

After a successful revocation, all future POST /v1/precall checks for this phone + calling entity will return allowed: false with reason: consumer_revoked until fresh prior express written consent is captured.

What honor_by_date means

The FCC requires companies to honor revocation requests within 10 business days (weekends and federal holidays excluded). The honor_by_date field is calculated automatically. If your organization is still making calls to this consumer after the honor-by date, you are in violation.

Code Examples

Node.js

await voice.revoke({
  phone: '+15551234567',
  callingEntity: 'Acme Insurance LLC',
  trigger: 'verbal_stop_during_call',
  transcript: 'Stop calling me',
});

Python

voice.revoke(
    phone="+15551234567",
    calling_entity="Acme Insurance LLC",
    trigger="verbal_stop_during_call",
    transcript="Stop calling me",
)