---
title: "Listar recursos"
method: GET
path: "/equipments"
tags: ["Recursos"]
---

# Listar recursos

`GET /equipments`

Lista os recursos que existem na sua organização.

## Query parameters

- `offset` integer
- `limit` integer
- `client_id` integer
- `include_manufacturer` boolean
- `include_system` boolean
- `include_technical_info` boolean

## Response `200`

- union
  - object[]
    - `id` integer, required — Identificador do recurso
    - `acquisition_date` string, required — Data de aquisição - Formato: YYYY-MM-DD
    - `agent` object, required — Informações do agente instalado na máquina
      - `email` string, required — Email do solicitante
      - `phone` string, required — Telefone do solicitante
      - `ramal` string, required — Ramal do solicitante
      - `user` string, required — Nome do solicitante
      - `version` string, required — Versão do agente instalada
    - `client` object, required — Cliente vinculado ao recurso
      - `id` integer, required — Identificador do cliente
      - `name` string, required — Nome do cliente
    - `equipment_group` object, nullable, required — Grupo de recurso
      - `id` integer — Identificador do grupo
      - `name` string — Nome do grupo
    - `equipment_type` object, nullable, required — Tipo de recurso
      - `id` integer — Identificador do tipo
      - `name` string — Nome do tipo
    - `ipv4` string, required — Informação do endereço IP
    - `last_connection` string, required — Data e hora do último acesso ao recurso
    - `last_seen` string, required — Última att?
    - `manufacturer` object, nullable — Informações do fabricante do recurso. Exibido apenas com `include_manufacturer=true`
      - `serial` string — TAG
      - `name` string — Nome
      - `model` string — Modelo
    - `monitoring_active` boolean, required — O monitoramento está ativo?
    - `name` string, required — Nome do recurso cadastrado no tiflux
    - `network_name` string, required — Nome de rede do computador
    - `online` boolean, required — O recurso está online?
    - `splashtop` boolean, required — O recurso possui Splashtop instalado e disponível para acesso?
    - `system` object, nullable — Informações do sistema do recurso. Exibido apenas com `include_system=true`
      - `name` string — Nome
      - `version` string — Versão
      - `kernel` string — Kernel
      - `service_pack` string — Atualização
    - `tipeertopeer` boolean, required — O recurso possui TiPeerToPeer instalado e disponível para acesso?
    - `updated_by_id` integer, required — Identificador do último usuário que atualizou alguma informação do recurso
    - `user` string, required — Nome do usuário do recurso
    - `warranty_date` string, required — Data de garantia - Formato: YYYY-MM-DD
  - object[]
    - `id` integer — Identificador do recurso
    - `acquisition_date` string — Data de aquisição - Formato: YYYY-MM-DD
    - `agent` object — Informações do agente instalado na máquina
      - `email` string, required — Email do solicitante
      - `phone` string, required — Telefone do solicitante
      - `ramal` string, required — Ramal do solicitante
      - `user` string, required — Nome do solicitante
      - `version` string, required — Versão do agente instalada
    - `client` object — Cliente vinculado ao recurso
      - `id` integer, required — Identificador do cliente
      - `name` string, required — Nome do cliente
    - `equipment_group` object, nullable — Grupo de recurso
      - `id` integer — Identificador do grupo
      - `name` string — Nome do grupo
    - `equipment_type` object, nullable — Tipo de recurso
      - `id` integer — Identificador do tipo
      - `name` string — Nome do tipo
    - `ipv4` string — Informação do endereço IP
    - `last_connection` string — Data e hora do último acesso ao recurso
    - `last_seen` string — Última att?
    - `manufacturer` object, nullable — Informações do fabricante do recurso. Exibido apenas com `include_manufacturer=true`
      - `serial` string — TAG
      - `name` string — Nome
      - `model` string — Modelo
    - `monitoring_active` boolean — O monitoramento está ativo?
    - `name` string — Nome do recurso cadastrado no tiflux
    - `network_name` string — Nome de rede do computador
    - `online` boolean — O recurso está online?
    - `splashtop` boolean — O recurso possui Splashtop instalado e disponível para acesso?
    - `system` object, nullable — Informações do sistema do recurso. Exibido apenas com `include_system=true`
      - `name` string — Nome
      - `version` string — Versão
      - `kernel` string — Kernel
      - `service_pack` string — Atualização
    - `tipeertopeer` boolean — O recurso possui TiPeerToPeer instalado e disponível para acesso?
    - `updated_by_id` integer — Identificador do último usuário que atualizou alguma informação do recurso
    - `user` string — Nome do usuário do recurso
    - `warranty_date` string — Data de garantia - Formato: YYYY-MM-DD
    - `processor` object, nullable — Processador do recurso. Exibido apenas com `include_technical_info=true`
      - `name` string, nullable
    - `memory` object, nullable — Memória RAM total do recurso, em gigabytes. Exibido apenas com `include_technical_info=true`
      - `total_gb` number, nullable
    - `motherboard` object, nullable — Placa-mãe do recurso. Exibido apenas com `include_technical_info=true`
      - `manufacturer` string, nullable
      - `model` string, nullable
      - `bios` string, nullable
    - `vga` object[] — Placas de vídeo (GPU) do recurso. Exibido apenas com `include_technical_info=true`
      - `name` string, nullable
      - `vram_mb` integer, nullable
    - `disks` object[] — Discos do recurso. Exibido apenas com `include_technical_info=true`
      - `name` string
      - `size_gb` number, nullable
      - `use_percent` number, nullable
    - `disksmart` object[] — Status S.M.A.R.T dos discos do recurso. Exibido apenas com `include_technical_info=true`
      - `model` string, nullable
      - `status` string, nullable
    - `network` object[] — Interfaces de rede do recurso. Exibido apenas com `include_technical_info=true`
      - `name` string
      - `ipv4` string, nullable
      - `mac` string, nullable
    - `antivirus` object[] — Antivírus instalados no recurso. Exibido apenas com `include_technical_info=true`
      - `name` string, nullable
      - `up_to_date` boolean, nullable
      - `active` boolean, nullable
    - `windows_update` object — Status de atualizações pendentes do Windows. Exibido apenas com `include_technical_info=true`
      - `pending_count` integer
      - `has_critical_pending` boolean
    - `sound` object[] — Dispositivos de áudio do recurso. Exibido apenas com `include_technical_info=true`
      - `name` string, nullable
    - `printer` object[] — Impressoras do recurso. Exibido apenas com `include_technical_info=true`
      - `name` string, nullable
      - `port` string, nullable
      - `default` boolean, nullable

## Other responses

- `403` — ### **Problemas com permissão** Essa resposta significa que o seu usuário está autenticado corretamente, porém, não possui a permissão ou licença necessária para acessar essa rota
- `422` — ### **Algo deu errado com os parâmetros informados**

---

[API](https://skmtc.net/tiflux/apis/tiflux-official-api.md) · [All operations](https://skmtc.net/tiflux/apis/tiflux-official-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiflux/tiflux-official-api/revisions/c656412a58bc/schema)