---
title: "Instances Connect"
method: GET
path: "/instance/connect/{instance}"
tags: ["Instance Controller"]
---

# Instances Connect

`GET /instance/connect/{instance}`

## Request

- Base URL: `https://evolution-example`
- URL: `https://evolution-example/instance/connect/{instance}`
- Auth: API key in header `apikey`

Generates and returns the QR code for WhatsApp connection

## Path parameters

- `instance` string, required

## Query parameters

- `number` string

## Response `200`

Ok

- object
  - `pairingCode` string: The unique code used for pairing a device or account.
  - `code` string: A specific code associated with the pairing process. This may include tokens or other identifiers.
  - `count` integer: The count or number of attempts or instances related to the pairing process.

## Other responses

- `404`: Instance not found

## Changes

- **2024-11-25** (v2) `c153448703e5`: 6 info
  - api operation id `instanceConnect` was added
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - api tag `Instance Controller` added
  - api tag `Instance` removed
  - …2 more
- **2024-09-09** (v2) `0c4620ca5ed5`: 1 warning, 5 info
  - deleted the `query` request parameter `number`
  - api operation id `instanceConnect` removed and replaced with ``
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - api tag `Instance` added
  - …2 more

[Operation history](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/changes/instance/connect/:instance/get.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/evolution-api-3.md) - [All operations](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/revisions/153363ee7f38?raw)