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.
Your Evolution API key for authentication.
Path Parameters The name of your WhatsApp instance.
Query Parameters 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.
Response WhatsApp JID of the chat.
Whether this is a group chat.
URL of the chat’s profile picture.
ISO 8601 timestamp of when the chat was created.
ISO 8601 timestamp of last update.
curl --request GET \ --url 'https://api.example.com/chat/findChatByRemoteJid/my-instance?remoteJid=5511999999999@s.whatsapp.net' \ --header 'apikey: YOUR_API_KEY'
200 Success
400 Bad Request
401 Unauthorized
404 Not Found
{ "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" }
Usage Notes 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
Use this endpoint before sending messages to verify that a chat exists and is accessible.