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

# Obter Unidades

> Obter todas as Unidades da Instituição

<Note>O resultado deve conter um array listando todos os widgets</Note>

## Token de Acesso

<ParamField header="Authorization" type="string">
  Token de acesso ("Bearer" deve estar antes do token)
</ParamField>

## Descrição da Resposta

Abaixo você verá a descrição da resposta

<ResponseField name="items" type="array" required>
  Lista de unidades e seus detalhes.

  <Expandable title="items">
    <ResponseField name="id" type="string" required>
      Identificador único da unidade.
    </ResponseField>

    <ResponseField name="institutionId" type="string" required>
      ID da instituição associada.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Nome da unidade.
    </ResponseField>

    <ResponseField name="isActivated" type="boolean" required>
      Status de ativação da unidade.
    </ResponseField>

    <ResponseField name="credentialProjectId" type="string" required>
      ID do projeto de credencial vinculado à unidade.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="unityCount" type="number" required>
  Número total de unidades.
</ResponseField>

<ResponseField name="activeCount" type="number" required>
  Número de unidades ativas.
</ResponseField>

<ResponseField name="unityLimit" type="number" required>
  Limite máximo de unidades permitidas.
</ResponseField>

## Segurança

Para acessar este endpoint, é necessário enviar um **token de acesso** válido através do cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para proteger os dados dos usuários.