---
title: "Get tools"
method: GET
path: "/tools/{category}"
tags: ["General"]
---

# Get tools

`GET /tools/{category}`

Get a list of the tools (i.e., integrations) enabled in your environment.
 This can (in combination with the `integration_tool` parameter of [the "Create Link" endpoint](/v1/post-create-link)) be used to, for example, display a custom list or grid of available integrations to your end users instead of exposing Kombo Connect's standard tool selector.

## Path parameters

- `category` 'hris' | 'ats' | 'assessment' | 'lms', required

## Response `200`

GET /tools/:category Positive response

- GetToolsCategoryPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `tools` object[], required
      - `id` string, required
      - `label` string, required
      - `internal_label` string, nullable, required — Internal label that can help you debug specific variants of the integration. Only show the `label` to your users.
      - `assets` object, required
        - `logo_url` string, required
        - `icon_url` string, required
        - `icon_black_url` string, required
      - `paid_api_details_markdown` string, nullable, required — Markdown formatted text that describes details about the paid API. `null` if the tool is not paid.
      - `fast_track_details_markdown` string, nullable, required — Markdown formatted text that describes details about the fast track process. `null` if the fast track process is not available.
      - `partner_only_details_markdown` string, nullable, required — Markdown formatted text that describes partnership requirements. `null` if the tool does not require a partnership.
      - `connection_guide_url` string, nullable, required — URL to the connection guide for this tool. `null` if no connection guide is available.
      - `coverage` object, required — This describes the supported models and actions of this tool.
        - `read_models` object[], required
          - `id` string, required — ID of the model (e.g. hris_employees).
          - `label` string, required — Label of the model (e.g. Employees).
          - `coverage_status` 'SUPPORTED' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'UNKNOWN', required — The status of a datapoint of an integrated tool: - `SUPPORTED`: the tool supports the datapoint and it can be used through Kombo. - `UNSUPPORTED`: the tool does not support the datapoint. - `NOT_IMPLEMENTED`: tool supports the datapoint but it was not integrated by Kombo for a given reason (see coverage grid). - `UNKNOWN`: the datapoint is not integrated yet and Kombo has no information about it's availability in the tool.
          - `fields` object[], required
            - `id` string, required — Key of the field in the model (e.g. first_name).
            - `coverage_status` 'SUPPORTED' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'UNKNOWN', required — The status of a datapoint of an integrated tool: - `SUPPORTED`: the tool supports the datapoint and it can be used through Kombo. - `UNSUPPORTED`: the tool does not support the datapoint. - `NOT_IMPLEMENTED`: tool supports the datapoint but it was not integrated by Kombo for a given reason (see coverage grid). - `UNKNOWN`: the datapoint is not integrated yet and Kombo has no information about it's availability in the tool.
        - `write_actions` object[], required
          - `id` string, required
          - `label` string, required
          - `coverage_status` 'SUPPORTED' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'UNKNOWN', required — The status of a datapoint of an integrated tool: - `SUPPORTED`: the tool supports the datapoint and it can be used through Kombo. - `UNSUPPORTED`: the tool does not support the datapoint. - `NOT_IMPLEMENTED`: tool supports the datapoint but it was not integrated by Kombo for a given reason (see coverage grid). - `UNKNOWN`: the datapoint is not integrated yet and Kombo has no information about it's availability in the tool.
          - `fields` object[], required
            - `id` string, required — Key of the input field (e.g. `candidate.first_name`).
            - `coverage_status` 'SUPPORTED' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'UNKNOWN', required — The status of a datapoint of an integrated tool: - `SUPPORTED`: the tool supports the datapoint and it can be used through Kombo. - `UNSUPPORTED`: the tool does not support the datapoint. - `NOT_IMPLEMENTED`: tool supports the datapoint but it was not integrated by Kombo for a given reason (see coverage grid). - `UNKNOWN`: the datapoint is not integrated yet and Kombo has no information about it's availability in the tool.
        - `features` object[], required
          - `id` string, required
          - `label` string, required
          - `coverage_status` 'SUPPORTED' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'UNKNOWN', required — The status of a datapoint of an integrated tool: - `SUPPORTED`: the tool supports the datapoint and it can be used through Kombo. - `UNSUPPORTED`: the tool does not support the datapoint. - `NOT_IMPLEMENTED`: tool supports the datapoint but it was not integrated by Kombo for a given reason (see coverage grid). - `UNKNOWN`: the datapoint is not integrated yet and Kombo has no information about it's availability in the tool.

## Other responses

- `default` — The standard error response with just the platform error codes.

---

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