---
title: "Get V2"
method: GET
path: "/v2/tiers/collection/{collection_key}"
tags: ["Tiers"]
---

# Get V2

`GET /v2/tiers/collection/{collection_key}`

Get a tier collection by key

## Path parameters

- `collection_key` string, required

## Response `200`

Get a tier collection by key

- object
  - `data` object, required
    - `tier_collection` object — **Tier Collections** group tiers and store target and cycle data.
      - `created_at` integer, nullable — Unix timestamp in milliseconds when the tier collection was created
      - `cycle` object, nullable — **Cycle** enable vendors to provide reward and feature levels.
        - `delay_length` integer, nullable — number of deplay units
        - `delay_unit` 'days' | 'weeks' | 'months' | 'years' | 'null', nullable — Cycle delay length unit
        - `key` string, nullable — A unique identifier to identify the cycle
        - `length` integer, nullable — Cycle Length - number of units
        - `repeats` integer, nullable — number to cycle repeats
        - `schedule_config` object, nullable — Schedule Config
        - `unit` 'days' | 'weeks' | 'months' | 'years' | 'null', nullable — Cycle Length Unit
      - `is_active` boolean
      - `key` string, nullable — A unique identifier to identify the tier
      - `name` string, nullable — Specifies name of the Tier
      - `tiers` object[]
        - `created_at` integer — Immutable Unix timestamp in milliseconds taken at time of creation
        - `key` string — A unique identifier used to reference the object
        - `updated_at` integer — Unix timestamp in milliseconds taken at time of last update
        - `benefits` object[] — Benefits of this tier
          - `description` string — Description of the tier's benefit
          - `name` string — Name of the tier's benefit
          - `order` integer, nullable — Display order of the benefit (0-based)
        - `color` string, nullable — Custom tier color for logo
        - `criteria` string[]
        - `features` object, nullable
        - `img` string, nullable — A unique identifier for the uploaded image/badge
        - `is_active` boolean, nullable
        - `is_current` boolean, nullable
        - `min_threshold` integer, nullable
        - `name` string, nullable — Specifies name of the Tier
        - `next_tier_key` string, nullable
        - `order` integer, nullable
        - `prev_tier_key` string, nullable
        - `threshold_type` 'net_sales' | 'custom_criteria', nullable — Type of tier threshold
        - `tier_collection_key` string, nullable — A unique identifier for the parent collection
  - `message` string, required
  - `status` integer, required

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Forbidden Error
- `404` — Not Found Error
- `500` — Internal Server Error

---

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