---
title: "Crosswalk"
method: GET
path: "/api/v1/crosswalk"
tags: ["lists", "lists"]
---

# Crosswalk

`GET /api/v1/crosswalk`

## Request

- Base URL: `https://app.goodleads.club` (the document declares no server; this is the origin it was published from)
- URL: `https://app.goodleads.club/api/v1/crosswalk`
- Auth: API key in header `X-API-Key`

One classification code in, the other three systems out — with our industry, the filter for each, and a live count.

We carry NAICS, SIC, the Google Business category and the payment MCC on every
record, tied together by our own taxonomy. Give any one (a code, or the words)
and get the equivalents, the ready-to-use filter per system, and how many
records are in it today. A code we do not carry widens through the crosswalk
(to its parent group, then to the codes it ties to) and says so in `widened`.
No key needed.

## Query parameters

- `q` string, nullable: A code or words: "MCC 5812", "SIC 1711", "NAICS 238220", "google category plumber", "restaurants".
- `system` string, nullable: naics | sic | mcc | google_category — with `code`, instead of `q`.
- `code` string, nullable: The code in `system`. A SIC or NAICS prefix (17, 238) is a whole group.
- `states` string: Comma-separated state codes for the live count; empty = every live state.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodleads/apis/formation-gtm-api.md) · [All operations](https://skmtc.dev/goodleads/apis/formation-gtm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodleads/apis/formation-gtm-api/revisions/2068d13a82cf?raw)