# Verificar status da instância

`GET /instance/status`

Pasta: **Instancia**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Verificar status da instância

Retorna o registro da instância (sanitizado) e o estado de runtime da ponte (conectado, logado, passkey, etc.).

Use para monitorar se a sessão está online antes de enviar mensagens.

## Endpoint

```http
GET {{baseUrl}}/instance/status
```

## Autenticação

Header da instância:

```http
token: {{token}}
```

## Exemplo de Requisição

```bash
curl -X GET "{{baseUrl}}/instance/status" \
  -H "token: {{token}}"
```

## Resposta de Sucesso

```json
{
  "success": true,
  "instance": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "token": "inst_abc123",
    "name": "Atendimento",
    "status": "connected",
    "owner": "5511999999999",
    "connection_mode": "companion",
    "profileName": "GoZap Bot"
  },
  "runtime": {
    "present": true,
    "connected": true,
    "logged_in": true
  }
}
```

## Erros comuns

- `401` — header `token` ausente ou inválido
- `500` — falha ao reconciliar status no bridge

## cURL

```bash
curl -X GET "{{baseUrl}}/instance/status" \
  -H "token: {{token}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/verificar-status-da-instancia)