> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pilotstatus.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# List all labels

> Returns every label defined on the connected number.



## OpenAPI

````yaml openapi.evolution-go.json GET /label/list
openapi: 3.1.0
info:
  title: Evolution GO Layer
  version: 1.0.0
  description: >-
    Pilot Status API Layer — Evolution GO. Base URL
    `https://pilotstatus.com.br/api/layer/evolution-go`. Authenticate with the
    `apikey` header (your Pilot Status `ps_` key) or `Authorization: Bearer`.
    Instance/session endpoints are NOT available through the layer.
servers:
  - url: https://pilotstatus.com.br/api/layer/evolution-go
security:
  - apiKey: []
tags:
  - name: Call (voice)
  - name: Chat
  - name: Community
  - name: Group
  - name: Label
  - name: Message
  - name: Newsletter / Channels
  - name: Send (load-balanced)
  - name: User / Contacts
paths:
  /label/list:
    get:
      tags:
        - Label
      summary: List all labels
      description: Returns every label defined on the connected number.
      operationId: get__label_list
      responses:
        '200':
          description: Success — provider-native response body.
          content:
            application/json:
              schema:
                type: array
                description: >-
                  List of labels stored for the instance (returned as a bare
                  array, no envelope)
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Internal record UUID (primary key) for this label row
                    instance_id:
                      type: string
                      description: UUID of the instance the label belongs to
                    label_id:
                      type: string
                      description: >-
                        WhatsApp label identifier used when (un)labeling
                        chats/messages
                    label_name:
                      type: string
                      description: Display name of the label
                    label_color:
                      type: string
                      description: WhatsApp label color index (stored as a string)
                    predefined_id:
                      type: string
                      description: >-
                        Predefined label identifier, empty for user-created
                        labels
                  required:
                    - id
                    - instance_id
                    - label_id
                    - label_name
                    - label_color
                    - predefined_id
              example:
                - id: b3f1c2e4-9a7d-4c2b-8e15-6d0f2a3b4c5d
                  instance_id: a1e2d3c4-5b6a-4789-9c0d-1e2f3a4b5c6d
                  label_id: '1'
                  label_name: Novo cliente
                  label_color: '0'
                  predefined_id: '1'
                - id: c4a2d3f5-0b8e-4d3c-9f26-7e1a3b4c5d6e
                  instance_id: a1e2d3c4-5b6a-4789-9c0d-1e2f3a4b5c6d
                  label_id: '2'
                  label_name: Pagamento pendente
                  label_color: '5'
                  predefined_id: ''
        default:
          description: Error — provider or layer error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  error:
                    type: string
                  message:
                    type: string
                  response:
                    type: object
              example:
                status: 400
                error: Bad Request
                message: Invalid payload
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: >-
        Your Pilot Status API key (ps_...). Evolution GO also accepts
        `Authorization: Bearer <key>`.

````