Whatsapp Phone Numbers

Get conversation window status for a phone number

Changed on

Returns whether the 24-hour conversation window is currently open for a given source/destination pair. If window_active is false, only template messages may be sent.

get/v2/whatsapp/phone_numbers/{phone_number}/conversation_window

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/v2/whatsapp/phone_numbers/{phone_number}/conversation_window
  • Auth: HTTP bearer

Path parameters

phone_numberstring required

Phone number (E.164 format)

Query parameters

destination_numberstring required
Example:+353894650851

Destination phone number in E.164 format

Response

Successful response with Whatsapp conversation window status

Example response

{
  "data": {
    "window_active": true,
    "window_expires_at": "2026-06-30T16:00:00Z",
    "last_user_message_at": "2026-06-29T15:53:00Z",
    "window_type": "24h"
  }
}

Changes

  • 1571b0380bd7Revision changes
    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

  • 8f5f4e537994Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the / response's property type changed from no type to object for status

    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • breaking

      the /// response's property format changed from json-pointer to no format for status