GET
/
api
/
v1
/
tiers
Get Tiers
curl --request GET \
  --url https://app.journeybee.io/api/v1/tiers \
  --header 'Authorization: Bearer <token>'
[
  {
    "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"
  }
]

​
Authentication

curl -X GET "https://app.journeybee.io/api/v1/tiers" \
  -H "Authorization: Bearer your-api-key-uuid" \
  -H "Content-Type: application/json"

​
Response Schema

​
tiers
array
Array of tier objects

​
Example Response

[
  {
    "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"
  }
]

​
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