> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/EvolutionAPI/evolution-api/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Labels

> Retrieve all labels from your WhatsApp Business account.

## Overview

You can fetch all labels (tags) configured in your WhatsApp Business account. Labels help you organize and categorize chats and contacts.

<Note>
  Labels are only available for WhatsApp Business accounts. Regular WhatsApp accounts do not support labels.
</Note>

## Authentication

This endpoint requires authentication via the `apikey` header.

<ParamField path="header.apikey" type="string" required>
  Your Evolution API key for authentication.
</ParamField>

## Path Parameters

<ParamField path="path.instanceName" type="string" required>
  The name of your WhatsApp Business instance.
</ParamField>

## Response

<ResponseField name="labels" type="array">
  Array of label objects.

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique label identifier.
    </ResponseField>

    <ResponseField name="name" type="string">
      Label name/text.
    </ResponseField>

    <ResponseField name="color" type="string">
      Label color code (hex format).
    </ResponseField>

    <ResponseField name="predefinedId" type="string">
      WhatsApp's predefined label ID, if applicable.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.example.com/label/findLabels/my-instance \
    --header 'apikey: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.example.com/label/findLabels/my-instance',
    {
      method: 'GET',
      headers: {
        'apikey': 'YOUR_API_KEY'
      }
    }
  );

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.example.com/label/findLabels/my-instance',
      headers={'apikey': 'YOUR_API_KEY'}
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "labels": [
      {
        "id": "1",
        "name": "New Customer",
        "color": "#00A0DC",
        "predefinedId": "1"
      },
      {
        "id": "2",
        "name": "Pending Payment",
        "color": "#F39C12",
        "predefinedId": "2"
      },
      {
        "id": "custom_123",
        "name": "VIP Client",
        "color": "#9B59B6",
        "predefinedId": null
      }
    ]
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "error": "Unauthorized",
    "message": "Invalid API key"
  }
  ```

  ```json 403 Forbidden theme={null}
  {
    "error": "Feature not available",
    "message": "Labels are only available for WhatsApp Business accounts"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "Instance not found",
    "message": "The instance 'my-instance' does not exist"
  }
  ```
</ResponseExample>

## Label Colors

WhatsApp Business provides predefined label colors:

<Tabs>
  <Tab title="Available Colors">
    * Blue: `#00A0DC`
    * Orange: `#F39C12`
    * Purple: `#9B59B6`
    * Green: `#16A085`
    * Red: `#E74C3C`
    * Gray: `#95A5A6`
  </Tab>
</Tabs>

## Usage Notes

<Info>
  WhatsApp Business allows you to create custom labels in addition to the predefined ones.
</Info>

<Tip>
  Use labels to organize chats by customer status, priority, or any other category relevant to your business.
</Tip>

<Note>
  Label management (creating, editing, deleting) is typically done through the WhatsApp Business app. This API allows you to fetch and assign existing labels.
</Note>