# Get Instance Status

**there are 7 instance statuses** 

1. `initialize` when the instance is being initialized and not ready yet to get the QR code.
2. `qr` ( when instance generating qr, this status only appears when you are logged out)
3. `loading_screen` (this status appears while  scanning QR and loading data )
4. `authenticated` ( this status appears before the instance becomes `ready` status )
5. `ready` ( this status appears when the instance is ready to send & receive messages after QR scanned )
6. `disconnected` ( this status appears when you are logged out from your device/phone )
7. `auth_failure` ( this status appears when the instance failure to authenticate your device for any reason )

## To get instance status

<mark style="color:blue;">`GET`</mark> `https://api.cartat.net/instance/status`

#### Headers

| Name                                            | Type             | Description                                                                           |
| ----------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------- |
| Accept<mark style="color:red;">\*</mark>        | application/json |                                                                                       |
| Content-Type<mark style="color:red;">\*</mark>  | application/json |                                                                                       |
| Authorization<mark style="color:red;">\*</mark> | Bearer {{token}} | you can find your access token [here](https://docs.cartat.net/cartat-api/get-started) |

{% tabs %}
{% tab title="200: OK " %}

```json
{
    "status": "qr"
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cartat.net/cartat-api/whatsapp-api/instance/get-instance-status.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.