---
title: "Get a collection of segment records"
method: GET
path: "/customers/{customer_id}/segment-records"
tags: ["Customers"]
---

# Get a collection of segment records

`GET /customers/{customer_id}/segment-records`

Get information about all segment records on a customer account.

Segments are groupings of customers based on shared attributes or behaviour, used for targeted marketing and personalisation. This endpoint returns all segment memberships currently recorded on the customer account.

Related: [GET /segments](https://carecloud.readme.io/reference/getsegments)

## Path parameters

- `customer_id` string, required

## Query parameters

- `segment_group_ids` string[]

## Headers

- `Accept-Language` string

## Response `200`

OK

- object
  - `data` object
    - `segment_records` SegmentRecord[] — List of segment records.
      - `segment_id` string, required — The unique ID of the segment. [GET /segments](https://carecloud.readme.io/reference/getsegments)
      - `customer_id` string, required — The unique ID of the customer. [GET /customers](https://carecloud.readme.io/reference/getcustomers)
      - `created_at` string, required — Timestamp of the segment record creation. Format: `YYYY-MM-DD HH:MM:SS`. All times are in the local timezone.
      - `last_change` string — Timestamp of the last change. Format: `YYYY-MM-DD HH:MM:SS`. All times are in the local timezone.
    - `total_items` integer — The number of all found segment records.

## Other responses

- `400` — Bad input parameter. The response body's `error.error_data.invalid_params[]` array lists the parameters that caused the failure, each carrying a `reason` code. See the `BadRequestErrorBody` schema for the generic reason taxonomy. Operations with domain-specific business rules document additional reasons at the operation level.
- `401` — The client has invalid credentials or auth token.
- `403` — The client does not exist or the client tried to access an unauthorized property or resource.
- `404` — The resource was not found.
- `405` — The resource does not support the specified HTTP method.
- `429` — Too many requests - more than the resource limit.
- `500` — Server is not working as expected.
- `503` — Temporary state when the service is temporarily unavailable, overloaded or there is a maintenance window.

---

[API](https://skmtc.net/crmcarecloud/apis/rest-api-reference.md) · [All operations](https://skmtc.net/crmcarecloud/apis/rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crmcarecloud/rest-api-reference/revisions/329c06dbf8d9/schema)