> ## Documentation Index
> Fetch the complete documentation index at: https://docs.journeybee.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Tiers

> Retrieve all partner tiers for managing partnership levels and benefits

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.journeybee.io/api/v1/tiers" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json"
  ```
</CodeGroup>

## Response Schema

<ResponseField name="tiers" type="array">
  Array of tier objects

  <Expandable title="Tier Object">
    <ResponseField name="id" type="number">Tier ID</ResponseField>
    <ResponseField name="uuid" type="string">Tier UUID</ResponseField>
    <ResponseField name="label" type="string">Tier name (e.g., "Gold", "Silver", "Bronze")</ResponseField>
    <ResponseField name="background_color" type="string">Background color (hex)</ResponseField>
    <ResponseField name="text_color" type="string">Text color (hex)</ResponseField>
    <ResponseField name="partner_type" type="string">Partner type: `referral`, `reseller`</ResponseField>
    <ResponseField name="company_id" type="number">Company ID</ResponseField>
  </Expandable>
</ResponseField>

## Example Response

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": 1,
      "uuid": "tier-uuid-123",
      "label": "Gold",
      "background_color": "#FFD700",
      "text_color": "#000000",
      "partner_type": "referral",
      "company_id": 123
    },
    {
      "id": 2,
      "label": "Silver",
      "background_color": "#C0C0C0",
      "text_color": "#000000"
    },
    {
      "id": 3,
      "label": "Bronze",
      "background_color": "#CD7F32",
      "text_color": "#FFFFFF"
    }
  ]
  ```
</ResponseExample>

## Notes

* Requires API key with `read_access` permission
* Tiers represent partnership levels with different benefits and commission rates
* Visual colors help identify tier levels in the UI