---
title: "Fetch tools/tool categories and their cost settings."
method: GET
path: "/tool_cost_setting/fetch"
tags: ["Cost control|Tool cost setting"]
---

# Fetch tools/tool categories and their cost settings.

`GET /tool_cost_setting/fetch`

This endpoint enables you to retrieve a list of tool cost settings.

## Query parameters

- `filter[byToolId]` integer
- `filter[byToolCategoryId]` integer
- `offset` integer
- `limit` integer

## Response `200`

Success Response:

- StandardToolCostHistoryFetchResponse
  - `data` object[] — The tool cost settings.
    - `id` integer — The internal id of the tool cost setting.
    - `tool` StandardToolBaseToolListItem
      - `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.
    - `toolCategory` StandardToolCategoryBaseToolCategoryListItem
      - `id` integer — The internal id of the tool category.
      - `name` string — The name of the tool category.
      - `description` string — The description of the tool category.
      - `externalId` string — The external id of the tool category.
      - `createdAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `costTypeSource` string — The source of the cost type for this setting.
    - `costType` string — The cost type for this setting.
    - `dailyRateSource` string — The Source of the daily rate for this setting.
    - `dailyRate` number — The daily rate for the tool for this setting.
    - `hourlyRate` number — The hourly rate for the tool for this setting.
    - `fallbackProject` number — The fallback project for this setting.
    - `automaticBooking` number — This indicates whether this setting should be used to create cost bookings automatically.
    - `from` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd
    - `to` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd
  - `offset` integer — Number of skipped records.
  - `totalCount` integer — Total number of available tool cost settings.

---

[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/869b05603541/schema)