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

# Get a collection of interest records

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

Get information about all interest records on a customer account.

Customer interests represent the categories or topics a customer has opted into or been assigned to. They are used to personalise communication and offers. Each interest record links the customer to an interest defined in the CareCloud platform.

Related: [GET /interests](https://carecloud.readme.io/reference/getinterests)

## Path parameters

- `customer_id` string, required

## Headers

- `Accept-Language` string

## Response `200`

OK

- object
  - `data` object
    - `interest_records` InterestRecord[] — List of interest records.
      - `interest_record_id` string — The unique ID of the interest record.
      - `interest_id` string, required — The unique ID of the interest. [GET /interests](https://carecloud.readme.io/reference/getinterests)
      - `customer_id` string, required — The unique ID of the customer. [GET /customers](https://carecloud.readme.io/reference/getcustomers)
      - `last_change` string — Date and time of the last change. *(YYYY-MM-DD HH:MM:SS)*
    - `total_items` integer — The number of all found interest 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)