Referência/Instances/getInstance
Instances

Consulta uma instância

Consulta uma instância

GEThttp://localhost:8084/instance/{instance}

Autenticação

InstanceBearerobrigatório

JWT HS256 da própria instância.

Header
Authorization
Exemplo
Bearer <INSTANCE_TOKEN>

Parâmetros

instancepathobrigatório
string

Nome público da instância

minLength 1

Respostas

application/json
200

Instância encontrada

response 200object
idintegerobrigatório
namestringobrigatório
descriptionstring | nullobrigatório
statusenum<ONLINE | OFFLINE>obrigatório
connectionStatusenum<offline | connecting | qr_code | pairing_code | pairing | online | reconnecting | disconnected | connection_timeout | logged_out | session_missing | stream_replaced | keepalive_timeout | client_outdated | temporary_ban | connection_error>obrigatório
ownerJidstring | nullobrigatório
profilePicUrlstring | nullobrigatório
createdAtstring | nullobrigatórioformat: date-time
updatedAtstring | nullobrigatórioformat: date-time
WebhookoneOfobrigatório
opção 1object
idintegerobrigatório
urlstringobrigatórioformat: uri
enabledbooleanobrigatório
eventsobjectobrigatório
callUpsertboolean
chatsDeletedboolean
chatsUpdatedboolean
connectionUpdatedboolean
contactsUpdatedboolean
contactsUpsertboolean
groupsParticipantsUpdatedboolean
groupsUpdatedboolean
groupsUpsertboolean
historySyncboolean
identityUpdatedboolean
labelsAssociationboolean
labelsEditboolean
mediaRetryboolean
messagesDeletedboolean
messagesStarredboolean
messagesUndecryptableboolean
messagesUpdatedboolean
messagesUpsertboolean
newsLetterboolean
presenceUpdatedboolean
profilePictureUpdatedboolean
qrcodeUpdatedboolean
sendMessageboolean
settingsUpdatedboolean
statusInstanceboolean
userAboutUpdatedboolean
createdAtstring | nullobrigatórioformat: date-time
updatedAtstringobrigatórioformat: date-time
instanceIdintegerobrigatório
opção 2null
Exemplo 200gerado do schema
{
"id": 1,
"name": "CodeChat",
"description": "string",
"status": "ONLINE",
"connectionStatus": "offline",
"ownerJid": "[email protected]",
"profilePicUrl": "string",
"createdAt": "2026-07-13T15:10:00Z",
"updatedAt": "2026-07-13T15:10:00Z",
"Webhook": {
"id": 1,
"url": "https://api.example.com/webhooks/codechat",
"enabled": true,
"events": {
"callUpsert": true,
"chatsDeleted": true,
"chatsUpdated": true,
"connectionUpdated": true,
"contactsUpdated": true,
"contactsUpsert": true,
"groupsParticipantsUpdated": true,
"groupsUpdated": true,
"groupsUpsert": true,
"historySync": true,
"identityUpdated": true,
"labelsAssociation": true,
"labelsEdit": true,
"mediaRetry": true,
"messagesDeleted": true,
"messagesStarred": true,
"messagesUndecryptable": true,
"messagesUpdated": true,
"messagesUpsert": true,
"newsLetter": true,
"presenceUpdated": true,
"profilePictureUpdated": true,
"qrcodeUpdated": true,
"sendMessage": true,
"settingsUpdated": true,
"statusInstance": true,
"userAboutUpdated": true
},
"createdAt": "2026-07-13T15:10:00Z",
"updatedAt": "2026-07-13T15:10:00Z",
"instanceId": 1
}
}