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

# Get WhatsApp Details

> Retrieve detailed information about a specific WhatsApp conversation including the message thread, delivery status, and metadata.

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication (e.g., `Bearer <your_token>`).
</ParamField>

### Path Parameters

<ParamField path="message_id" type="string" required>
  The unique identifier of the WhatsApp message/conversation.
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates whether the request was successful.
</ResponseField>

<ResponseField name="data" type="object">
  WhatsApp message details object.

  <Expandable title="properties">
    <ResponseField name="message_id" type="string">Unique message identifier.</ResponseField>
    <ResponseField name="wamid" type="string">WhatsApp message ID assigned by Meta.</ResponseField>
    <ResponseField name="agent_id" type="string">AI agent that handled the conversation.</ResponseField>

    <ResponseField name="conversation" type="array">
      Full conversation thread (auto-fetched if available).

      <Expandable title="message object">
        <ResponseField name="role" type="string">Speaker identifier: `assistant` or `user`.</ResponseField>
        <ResponseField name="content" type="string">Message content.</ResponseField>
        <ResponseField name="timestamp" type="string">Message timepstamp of sent/received.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="name" type="string">Customer's name as specified in campaign data</ResponseField>
    <ResponseField name="campaign_id" type="string">Campaign the message belongs to.</ResponseField>
    <ResponseField name="to" type="string">Customer's WhatsApp number.</ResponseField>

    <ResponseField name="status" type="string">
      Overall conversation status.

      <Expandable title="possible values">
        * `Accepted` — Message Accepted.
        * `Sent` — Message Sent.
        * `Delivered` — Message delivered.
        * `Read` — Message read.
        * `Failed` — Message failed to sent.
      </Expandable>
    </ResponseField>

    <ResponseField name="template_id" type="string">WhatsApp template ID.</ResponseField>
    <ResponseField name="errors" type="array">List of errors if any.</ResponseField>
    <ResponseField name="loan_id" type="string">Present only for Collection organizations. Unique loan identifier of the customer.</ResponseField>
    <ResponseField name="lead_id" type="string">Present only for Lead Generation organizations. Unique lead identifier of the customer.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true,
    "data": {
      "message_id": "eqZxFCfgLXtuHlyOikbMjoVImlJzZQ",
      "wamid": "wamid.HBgMOTE4MjQ5NTg3NTUyFQIAERgSREYzODA5ODlFQzdBQjVDNzBGAA==",
      "agent_id": "PPTnLQAvGlLtVgRbpcFn",
      "campaign_id": "xyGwYgmSSUsGKtTPmxTv",
      "to": "8249587552",
      "status": "Accepted",
      "template_id": "hfu7VL6sBhI6NPm",
      "name": "Subhranshu Choudhury",
      "loan_id": "LOANID-2043153",
      "conversation": [
        {
          "role": "assistant",
          "content": "Hi Anmol, this is to remind you of your upcoming auto-pay: \n\nDate: 2025-06-11\nAccount: 3583791\nAmount: 10000\n\nThank you and have a nice day.",
          "timestamp": "2026-02-12T16:23:36"
        },
        {
          "role": "user",
          "content": "Hi",
          "timestamp": "2026-02-12T16:28:58"
        },
        {
          "role": "assistant",
          "content": "Hi Anmol,\n\nWelcome to timepay.ai! I'm your personal credit coach, here to assist you in resolving your negative accounts.\n\nLet's get started.\n",
          "timestamp": "2026-02-12T16:28:59"
        },
        {
          "role": "user",
          "content": "Yes",
          "timestamp": "2026-02-12T16:29:10"
        },
        {
          "role": "assistant",
          "content": "Please wait while we fetch your accounts...\n",
          "timestamp": "2026-02-12T16:29:11"
        },
        {
          "role": "user",
          "content": "Any update",
          "timestamp": "2026-02-12T16:29:37"
        }
      ],
      "errors": []
    }
  }
  ```

  ```json 400 Invalid Request theme={null}
  {
    "success": false,
    "message": "message_id is required and must be a string"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "success": false,
    "message": "WhatsApp message not found"
  }
  ```

  ```json 500 Server Error theme={null}
  {
    "success": false,
    "error": "Internal Server Error",
    "message": "An unexpected error occurred"
  }
  ```
</ResponseExample>
