> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/EvolutionAPI/evolution-api/llms.txt
> Use this file to discover all available pages before exploring further.

# Find Chat by JID

> Find a specific chat by its remote JID (WhatsApp ID).

## Overview

You can retrieve detailed information about a specific chat using its remote JID. This is useful when you need to get chat details before sending messages or performing chat-specific operations.

## Authentication

This endpoint requires authentication via the `apikey` header.

<ParamField path="header.apikey" type="string" required>
  Your Evolution API key for authentication.
</ParamField>

## Path Parameters

<ParamField path="path.instanceName" type="string" required>
  The name of your WhatsApp instance.
</ParamField>

## Query Parameters

<ParamField query="remoteJid" type="string" required>
  The WhatsApp JID of the chat you want to find. For individual chats, use the format `5511999999999@s.whatsapp.net`. For groups, use the format `120363123456789@g.us`.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique chat identifier.
</ResponseField>

<ResponseField name="remoteJid" type="string">
  WhatsApp JID of the chat.
</ResponseField>

<ResponseField name="owner" type="string">
  Instance owner.
</ResponseField>

<ResponseField name="isGroup" type="boolean">
  Whether this is a group chat.
</ResponseField>

<ResponseField name="name" type="string">
  Chat display name.
</ResponseField>

<ResponseField name="profilePictureUrl" type="string">
  URL of the chat's profile picture.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when the chat was created.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  ISO 8601 timestamp of last update.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.example.com/chat/findChatByRemoteJid/my-instance?remoteJid=5511999999999@s.whatsapp.net' \
    --header 'apikey: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const remoteJid = encodeURIComponent('5511999999999@s.whatsapp.net');

  const response = await fetch(
    `https://api.example.com/chat/findChatByRemoteJid/my-instance?remoteJid=${remoteJid}`,
    {
      method: 'GET',
      headers: {
        'apikey': 'YOUR_API_KEY'
      }
    }
  );

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests
  import urllib.parse

  remote_jid = urllib.parse.quote('5511999999999@s.whatsapp.net')

  response = requests.get(
      f'https://api.example.com/chat/findChatByRemoteJid/my-instance?remoteJid={remote_jid}',
      headers={'apikey': 'YOUR_API_KEY'}
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "id": "chat_123",
    "remoteJid": "5511999999999@s.whatsapp.net",
    "owner": "my-instance",
    "isGroup": false,
    "name": "John Doe",
    "profilePictureUrl": "https://example.com/profile.jpg",
    "createdAt": "2024-03-04T10:30:00.000Z",
    "updatedAt": "2024-03-04T12:45:00.000Z"
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "error": "remoteJid is a required query parameter"
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "error": "Unauthorized",
    "message": "Invalid API key"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "Chat not found",
    "message": "No chat found with the specified remoteJid"
  }
  ```
</ResponseExample>

## Usage Notes

<Info>
  The remoteJid format varies based on chat type:

  * Individual chats: `{phone_number}@s.whatsapp.net`
  * Group chats: `{group_id}@g.us`
  * Broadcast lists: `{broadcast_id}@broadcast`
</Info>

<Tip>
  Use this endpoint before sending messages to verify that a chat exists and is accessible.
</Tip>