---
title: "Get the wizard tool catalog"
method: GET
path: "/api/wizard/tool_catalog/"
tags: ["wizard", "wizard"]
---

# Get the wizard tool catalog

`GET /api/wizard/tool_catalog/`

## Request

- Base URL: `https://us.posthog.com`
- URL: `https://us.posthog.com/api/wizard/tool_catalog/`
- Auth: none required

Every tool the wizard can detect in a codebase, with the signals that identify it.

## Response `200`

- WizardToolCatalog
  - `schema_version` integer, required: Bumped when the shape changes in a way an older wizard cannot read.
  - `tools` WizardCatalogTool[], required: Every tool the wizard can detect.
    - `kind` string, required: Unique tool identifier, such as `Stripe` or `Hotjar`.
    - `label` string, required: Human-readable tool name.
    - `warehouse_source_type` string, nullable, required: Data warehouse source type the tool imports as, or null for a tool with no warehouse source.
    - `wizard_setup_mode` union, required: How the wizard sets up the source: in the terminal or in the app. Null for a tool with no warehouse source. * `in-cli` - In the terminal * `deep-link` - In the app
      - 'in-cli' | 'deep-link': * `in-cli` - In the terminal * `deep-link` - In the app
      - unknown
    - `alternative_to` string[], required: PostHog products this tool is an alternative to.
    - `superseded_by` string[], required: Kinds that reach the same data through a more specific source. When one of them also matches, the wizard drops this tool.
    - `signals` WizardCatalogToolSignals, required
      - `env_key_patterns` string[], required: Anchored regexes matched against `.env` key names. Values are never read.
      - `script_hosts` string[], required: Hosts matched against script URLs. A host also matches its subdomains.
      - `packages` object, required: Package names keyed by ecosystem, such as `npm`, `pypi` or `maven`.

## Changes

> 52 revisions in range; 1 not diffed.

- **2026-10-15** `98642c559af2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/posthog/apis/posthog-api/changes/api/wizard/tool_catalog/get.md)

---

[API](https://skmtc.dev/posthog/apis/posthog-api.md) · [All operations](https://skmtc.dev/posthog/apis/posthog-api/llms.txt) · [OpenAPI document](https://skmtc.dev/posthog/apis/posthog-api/revisions/71e64193672d?raw)