# Retrieve market segment by ID

Fetch detailed information about a specific market segment within the Property Management System (PMS) using its unique ID. Market segments categorise customer groups based on booking behaviors, demographics, or business classifications such as corporate, leisure, government, or wholesale. This endpoint is useful for retrieving segment-specific data for reporting, pricing strategies, and targeted marketing efforts. The response includes details about the market segment, including its classification and associated metadata. If the specified market segment ID does not exist, a  error will be returned. In case of an unexpected system error, a  will be triggered.

Endpoint: GET /api/v3/marketSegments/{id}
Version: 3.0.4
Security: OAuth2

## Path parameters:

  - `id` (integer, required)
    Unique identifier of the market segment

## Response 200 fields (application/json):

  - `id` (integer)
    Unique identifier of the market segment

  - `name` (string, required)
    Name of the market segment