---
title: "Fetch tool list."
method: GET
path: "/tool/fetch"
tags: ["Tools|Tool"]
---

# Fetch tool list.

`GET /tool/fetch`

This endpoint enables you to retrieve a list of tools that are under geoCapture's management. You will receive
fundamental details such as the tool's `serialNumber`, `toolCategory` name, and `toolManufacturer` name. You can
establish maintenance schedules within a tool to coordinate tool inspections, for instance. The status aims to
enhance tool management efficiency within the company.

## Query parameters

- `filter[byIds][]` integer[]
- `filter[bySerialNumbers][]` string[]
- `filter[byExternalIds][]` string[]
- `filter[byBeaconIds][]` string[]
- `filter[byLicenseNumbers][]` string[]
- `offset` integer
- `limit` integer

## Response `200`

Success Response:

- StandardToolFetchResponse
  - `data` object[] — The tools.
    - `id` integer — The internal id of the tool.
    - `name` string — The name of the tool.
    - `category` string — The name of the tool's category.
    - `serialNumber` string — The serial number of the tool.
    - `inventoryNumber` string — The inventory number of the tool.
    - `externalId` string — The external ID of the tool.
    - `status` string — The status of the tool.
    - `manufacturer` string — The name of the manufacturer of the tool.
    - `vehicleId` string — The id of the assigned locating device if it is a vehicle.
    - `beaconId` string — The id of the assigned locating device if it is a beacon.
    - `currentProject` StandardToolBaseProjectItem
      - `id` integer — The internal project ID.
      - `reference` string — The project number.
      - `importSource` string — External data source from which this project originated.
      - `importKey` string — External ID from the respective data source.
      - `name` string — The project name.
    - `multipleProjectsPossible` boolean — Indicates if multiple current projects were possible.
    - `currentProjectChangedAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `createdAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `licenseNumber` string — The license plate of the tool.
  - `offset` integer — Number of skipped records.
  - `totalCount` integer — Total number of available tools.

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/15839b24c497/schema)