---
title: "Get User Segments"
method: GET
path: "/users/{userId}/segments"
tags: ["Users", "Segments"]
---

# Get User Segments

`GET /users/{userId}/segments`

Find out which segments a user belongs to. Returns segment membership data including segment ID, name, type, and preset identifier.

This endpoint returns membership data (not analytics), so it is available on **all plans** including Free.

## Path parameters

- `userId` string, uuid, required — The user ID to get segment memberships for

## Response `200`

User segments retrieved successfully

- UserSegmentMembership[] — Array of segments the user belongs to.
  - `id` string, uuid, required — The segment ID.
  - `name` string, required — The segment name.
  - `type` string, required — The segment type (system or custom).
  - `presetId` string, nullable, required — The preset identifier for system segments, or null for custom segments.

## Other responses

- `404` — User not found

## Changes

- **2026-05-01** `f52e699d4abf` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/changes/users/:userId/segments/get.md)

---

[API](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference.md) · [All operations](https://skmtc.dev/greenflash-ai/apis/greenflash-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenflash-ai/greenflash-api-reference/revisions/c566e560677d/schema)