---
title: "List Distributor View Tier Changes"
method: GET
path: "/api/v1/distributor/tier-changes"
tags: ["User APIs", "distributor-view"]
---

# List Distributor View Tier Changes

`GET /api/v1/distributor/tier-changes`

Record of applied tier changes for the LP's own contracts. No
``contract_id`` spans every contract the LP holds; a ``contract_id`` scopes
to one owned contract (ownership-checked). Changes apply immediately, so
this is a record of applied changes, not a review queue.

## Query parameters

- `contract_id` string, uuid, nullable
- `search` string, nullable

## Response `200`

Successful Response

- TierChangeRecordListResponse
  - `items` TierChangeRecord[], required
    - `client_id` string, uuid, required
    - `company` string, required
    - `distributor_name` string, nullable
    - `contract_id` string, uuid, required
    - `contract_name` string, nullable
    - `from_tier_name` string, nullable
    - `from_daily_cap` integer, nullable
    - `to_tier_name` string, required
    - `to_daily_cap` integer, required
    - `monthly_delta_cents` integer, required
    - `joined_at` string, date, nullable
    - `changed_at` string, date, nullable
    - `applied_at` string, date-time, required
    - `license_expires_at` string, date, nullable
    - `requested_by` string, nullable
  - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)