---
title: "Get a market grouping by ID"
method: GET
path: "/api/market/grouping/{id}"
tags: ["Market Grouping"]
---

# Get a market grouping by ID

`GET /api/market/grouping/{id}`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/market/grouping/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/market/grouping/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single market grouping with its configuration

## Path parameters

- `id` integer, required

## Response `200`

Market grouping details

- MarketGroupingManagementResource
  - `id` integer: Market grouping ID
  - `level` string: Territory level (country, continent, generic)
  - `level_id` integer: ID of the territory (country or continent)
  - `name` string: Market grouping name
  - `slug` string: Market grouping slug
  - `editable` boolean: Whether the market grouping is editable
  - `supports` object[]: Array of supported territory types
    - `id` integer: Territory type ID
    - `type` string: Territory type (city, county, state, country, continent)
    - `name` string: Territory type name
    - `enabled` boolean: Whether this territory type is enabled
    - `multi` boolean: Whether multiple selections are allowed
  - `state_alias` string, nullable: State alias (only for country level)
  - `state_count` integer, nullable: Number of states (only for country level)
  - `county_count` integer, nullable: Number of counties (only for country level)
  - `city_count` integer, nullable: Number of cities (only for country level)
  - `created_at` string, date-time: Creation timestamp
  - `updated_at` string, date-time: Last update timestamp

## Other responses

- `401`: Unauthenticated
- `404`: Market grouping not found

---

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