Fetch All Connected Instances
GET/api/v2/business/:businessId/instance/connected
Retrieve all connected instances linked to a specific business.
Request
Path Parameters
Business ID.
Responses
- 200
- 400
- 401
BusinessInstancesConnectedResponse
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- Array [
- ]
- ]
Instances object[]required
Auth object
WhatsApp object
Webhook object[]required
Identification name of your webhook
Instance unique url.
Default value: false
Enable or disable the url.
WebhookEvents object
Default value: true
Enables sending the qr code.
Default value: true
Enables sending instance State.
Default value: true
Enables batch sending of old messages.
Default value: true
Enables sending of all new incoming messages.
Default value: true
Enables sending all updates to the incoming or outgoing message.
Default value: true
Enables the sending of all messages sent by the API.
Default value: true
Enables sending the initial batch of loaded contacts.
Default value: true
Enables sending a new contact with additional information.
Default value: true
Enable update notification for each contact in the conversation.
Default value: true
Enables notification of contact behavior in chat.
Default value: true
Enables sending all loaded chats.
Default value: true
Enable notification of each chat update in the conversation.
Default value: true
Enable notification of every new chat started.
Default value: true
Enable notification when a chat is deleted.
Default value: true
Enable notification when a group is created.
Default value: true
c
Default value: true
Enable notification when a member of a group is updated.
Default value: true
Enable notification when connection status changes.
Default value: true
Default value: true
Enable notification when the json web token is updated.
{
  "businessId": "string",
  "name": "string",
  "Instances": [
    {
      "instanceId": "string",
      "name": "string",
      "state": "string",
      "connection": "string",
      "createdAt": "2025-06-12T13:21:07.057Z",
      "deletedAt": "2025-06-12T13:21:07.057Z",
      "Auth": {
        "authId": "string",
        "jwt": "string",
        "createdAt": "2025-06-12T13:21:07.057Z",
        "updatedAt": "2025-06-12T13:21:07.057Z"
      },
      "WhatsApp": {
        "whatsappId": "string",
        "remoteJid": "string",
        "pictureUrl": "string",
        "pushName": "string",
        "createdAt": "string"
      },
      "Webhook": [
        {
          "name": "string",
          "url": "string",
          "enabled": false,
          "webhookId": "string",
          "createdAt": "2025-06-12T13:21:07.057Z",
          "updatedAt": "2025-06-12T13:21:07.057Z",
          "instanceInstanceId": "string",
          "WebhookEvents": {
            "qrcodeUpdate": true,
            "stateInstance": true,
            "messagesSet": true,
            "messagesUpsert": true,
            "messagesUpdate": true,
            "sendMessage": true,
            "contactsSet": true,
            "contactsUpsert": true,
            "contactsUpdate": true,
            "presenceUpdate": true,
            "chatsSet": true,
            "chatsUpdate": true,
            "chatsUpsert": true,
            "groupsUpsert": true,
            "groupUpdate": true,
            "groupParticipantsUpdate": true,
            "connectionUpdate": true,
            "callUpsert": true,
            "newJwt": true,
            "webhookEventsId": "string",
            "createdAt": "2025-06-12T13:21:07.058Z",
            "updatedAt": "2025-06-12T13:21:07.058Z"
          }
        }
      ]
    }
  ]
}
BadRequestException
- application/json
- Schema
- Example (from schema)
Schema
Default value: string,[object Object]
{
  "message": [
    "string"
  ],
  "error": "string",
  "statusCode": 0
}
UnauthorizedException
- application/json
- Schema
- Example (from schema)
Schema
Default value: string,[object Object]
{
  "message": [
    "string"
  ],
  "error": "string",
  "statusCode": 0
}