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

# Metadata do canal

> Retorna o metadata do canal com todas as informações

## Conceituação

Este método retorna o metadata do canal com todas as informações do canal e de sua visualização.

***

## Atributos

### Header

<ParamField path="instanceId" type="string" required>
  ID da sua instância. Disponível no painel Z-API em **Instâncias**.
</ParamField>

<ParamField path="token" type="string" required>
  Token da sua instância Z-API.
</ParamField>

### Path

<ParamField path="newsletterId" type="string" required>
  ID do canal
</ParamField>

***

## Response

### 200

<ResponseField name="id" type="string">
  ID do canal
</ResponseField>

<ResponseField name="creationTime" type="number">
  Timestamp de criação do canal
</ResponseField>

<ResponseField name="state" type="string">
  Estado do canal (ACTIVE ou NON\_EXISTING)
</ResponseField>

<ResponseField name="name" type="string">
  Nome do canal
</ResponseField>

<ResponseField name="description" type="string">
  Descrição do canal
</ResponseField>

<ResponseField name="subscribersCount" type="string">
  Número de inscritos do canal
</ResponseField>

<ResponseField name="inviteLink" type="string">
  Link de convite do canal
</ResponseField>

<ResponseField name="verification" type="string">
  Status de verificação (VERIFIED ou UNVERIFIED)
</ResponseField>

<ResponseField name="picture" type="string">
  URL da imagem do canal
</ResponseField>

<ResponseField name="preview" type="string">
  URL da imagem de preview do canal
</ResponseField>

<ResponseField name="viewMetadata" type="object">
  Informações de visualização do canal

  <Expandable title="Propriedades">
    <ResponseField name="mute" type="string">
      Status de mute do canal (ON ou OFF)
    </ResponseField>

    <ResponseField name="role" type="string">
      Papel do usuário no canal (OWNER ou SUBSCRIBER)
    </ResponseField>
  </Expandable>
</ResponseField>

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "id": "999999999999999999@newsletter",
  "creationTime": 1695124988,
  "state": "ACTIVE",
  "name": "Nome do canal",
  "description": "Descrição",
  "subscribersCount": "150",
  "inviteLink": "https://whatsapp.com/channel/...",
  "verification": "VERIFIED",
  "picture": "https://...",
  "preview": "https://...",
  "viewMetadata": {
    "mute": "OFF",
    "role": "OWNER"
  }
}
```

<Info>
  O ID do canal sempre deve conter o sufixo **@newsletter**, pois esse é o padrão utilizado pelo próprio WhatsApp.
</Info>

### 405

Neste caso certifique que esteja enviando corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no início deste tópico.

### 415

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json".