> ## Documentation Index
> Fetch the complete documentation index at: https://docs.periskope.app/llms.txt
> Use this file to discover all available pages before exploring further.

# The Phone Object

> The Phone object represents an organisation phone on Periskope.

<ResponseExample>
  ```json The Phone Object theme={null}
  {
      "org_id": "2997dd64-89bf-48d3-9a22-b314fca017e5",
      "org_phone": "918527184400@c.us",
      "created_at": "2024-12-15T11:47:26.668505+00:00",
      "updated_at": "2025-01-20T07:51:48.209+00:00",
      "wa_state": "CONNECTED",
      "phone_id": "phone-bqzvyibhmwkaergr",
      "qr_code": null,
      "phone_image": "https://storage.googleapis.com/periskope-images/2997dd64-89bf-48d3-9a22-b314fca017e5%2F918527184400%40c.us.jpg?timestamp=1737141384215",
      "phone_name": "Support",
      "first_connected_at": "2024-12-15T11:47:49.649+00:00",
      "is_ready": true,
      "label_ids": {
          "label-bflirzqiodgianfh": true,
          "label-rbdshklasmlbfczf": true
      },
      "labels": [
          "test1",
          "test2"
      ]
  }
  ```
</ResponseExample>

**Attributes**

<ParamField path="org_id" type="string">
  The unique identifier of the organization that owns this WhatsApp phone.
</ParamField>

<ParamField path="org_phone" type="string">
  The WhatsApp ID of the phone (format: `{phone_number}@c.us`).
</ParamField>

<ParamField path="created_at" type="string">
  The ISO 8601 formatted timestamp when the phone was first created.
</ParamField>

<ParamField path="updated_at" type="string">
  The ISO 8601 formatted timestamp when the phone was last updated.
</ParamField>

<ParamField path="wa_state" type="string">
  The current connection state of the WhatsApp account. Possible values are `CONNECTED`, `DISCONNECTED`.
</ParamField>

<ParamField path="phone_id" type="string">
  A unique identifier for this phone instance.
</ParamField>

<ParamField path="qr_code" type="string | null">
  The QR code string for WhatsApp Web authentication. Null when already connected.
</ParamField>

<ParamField path="phone_image" type="string">
  The URL of the WhatsApp profile image for this phone.
</ParamField>

<ParamField path="phone_name" type="string">
  The display name configured for this WhatsApp account.
</ParamField>

<ParamField path="first_connected_at" type="string">
  The ISO 8601 formatted timestamp when the phone first connected to WhatsApp.
</ParamField>

<ParamField path="is_ready" type="boolean">
  Indicates if the phone is fully configured and ready to send/receive messages.
</ParamField>

<ParamField path="label_ids" type="object">
  A mapping of label IDs to boolean values indicating which labels are assigned to this phone.
</ParamField>

<ParamField path="labels" type="array">
  An array of label names assigned to this phone.
</ParamField>

<ParamField path="is_browser_open" type="boolean">
  Indicates if the phone session on the server is currently open. If false, then please use the restart phone API to start the session
</ParamField>