---
title: "Returns specific tool"
method: GET
path: "/tools/{toolId}"
tags: ["Tools"]
---

# Returns specific tool

`GET /tools/{toolId}`

## Path parameters

- `toolId` integer, required

## Response `200`

Tool

- object
  - `data` Tool — Available relations: group, assignments, unarchived_assignments, archived_assignments, picture, changelog
    - `id` integer
    - `first_line` string — First line
    - `icon` string — Icon
    - `color` string — Color
    - `contrast_color` 'dark' | 'white' — Contrast color
    - `custom_number` string — Custom number
    - `picture_is_avatar` boolean — Picture is avatar
    - `group_id` integer — Tool group
    - `picture_id` integer — Photo
    - `manufacturer` string — The manufacturer of the tool
    - `model` string — The model of the tool
    - `serial_number` string — The serial number of the tool
    - `date_of_purchase` string, date — The date of purchase
    - `next_maintenance` string, date-time — The date of next maintenance
    - `condition` 'NEW' | 'USED' | 'LEASED' | 'DEFECT' | 'SORTED_OUT' — The condition of the tool
    - `info` string — Additional information about the tool
    - `source` string — The source of the tool data
    - `source_external_id` string, nullable — The external ID from the source
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401` — The request lacks valid authentication credentials.
- `403` — The token is valid but lacks the permission for this action.
- `404` — The requested resource could not be found.
- `422` — The request was well-formed but contains semantic errors (validation failed).
- `500` — An unexpected error occurred on the server (e.g. a requested relation does not exist).

---

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