---
title: "Get WhatsApp Session Status"
method: GET
path: "/user/whatsapp/session-status"
tags: ["WhatsApp"]
---

# Get WhatsApp Session Status

`GET /user/whatsapp/session-status`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/whatsapp/session-status`
- Auth: HTTP bearer

Check the 24-hour WhatsApp messaging window status for a Famulor conversation

[Docs](https://docs.famulor.io/api-v1/whatsapp/session-status)

## Query parameters

- `sender_id` integer, required
- `recipient_phone` string, required

## Response `200`

OK

- object
  - `success` boolean: Whether the request was successful
  - `has_conversation` boolean: Whether a conversation exists with this recipient
  - `conversation_id` integer: The conversation ID (only present when `has_conversation` is `true`)
  - `customer_name` string: The customer's name if available (only present when `has_conversation` is `true`)
  - `last_customer_message_at` string: ISO 8601 timestamp of the customer's last message (only present when `has_conversation` is `true`)
  - `session_status` object
    - `is_open` boolean: Whether the 24-hour messaging window is currently open
    - `can_send_freeform` boolean: Whether freeform (non-template) messages can be sent right now
    - `requires_template` boolean: Whether a template message is required to message this recipient
    - `message` string: Human-readable description of the current session state
    - `minutes_remaining` integer: Minutes remaining in the 24-hour window (only present when session is open)
    - `expires_at` string: ISO 8601 timestamp when the session expires (present when session is open or no customer message exists)
    - `expired_at` string: ISO 8601 timestamp when the session expired (only present when session has expired)
  - `404 Not Found` string

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `404`: Sender Not Found
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)