---
title: "List Tier Changes"
method: GET
path: "/api/v1/admin/distributors/tier-changes"
tags: ["Admin APIs", "distributors", "Wholesale Distribution"]
---

# List Tier Changes

`GET /api/v1/admin/distributors/tier-changes`

Record of applied tier changes (PRO-2569). No ``contract_id`` = every
distributor (the landing-page record); a ``contract_id`` scopes to one
contract (the contract-detail Change Requests subtab). Approval is
automatic, 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)