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

# List equipment with filters



## OpenAPI

````yaml /api-reference/operacoes.yaml get /v2/equipment
openapi: 3.0.0
info:
  title: Tarefy API
  description: >-
    Tarefy REST API — task management, culture and performance platform.


    Endpoints are versioned at `/v2/...`. Authentication via Bearer JWT in the
    `Authorization` header.


    To get started, see the [authentication guide](/authentication) and the
    [quickstart](/quickstart).
  version: 2.0.0
  contact:
    name: Tarefy Support
    email: suporte@tarefy.com
    url: https://tarefy.com
  license:
    name: Proprietary
    url: https://tarefy.com
servers:
  - url: https://app.tarefy.com/nodeapi
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Equipment
    description: Equipment assigned to users
  - name: Equipment Categories
    description: Equipment categories
  - name: Resource Allocation
    description: Resource allocation by project
  - name: Storage
    description: Upload files
paths:
  /v2/equipment:
    get:
      tags:
        - Equipment
      summary: List equipment with filters
      parameters:
        - in: query
          name: status
          required: false
          schema:
            type: string
        - in: query
          name: category_id
          required: false
          schema:
            type: integer
            nullable: true
        - in: query
          name: responsible_user_id
          required: false
          schema:
            type: integer
            nullable: true
        - in: query
          name: search
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Lista de equipamentos retornada com sucesso
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````