GET
/
api
/
v1
/
tags
Get Tags
curl --request GET \
  --url https://app.journeybee.io/api/v1/tags \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 10,
    "uuid": "tag-uuid-123",
    "label": "High Priority",
    "background_color": "#EF4444",
    "text_color": "#FFFFFF",
    "association": "lead",
    "partner_type": "referral",
    "company_id": 123
  },
  {
    "id": 11,
    "label": "Enterprise",
    "background_color": "#8B5CF6",
    "text_color": "#FFFFFF",
    "association": "lead_deal"
  }
]

​
Authentication

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

​
Query Parameters

​
association
string
Filter by association type. Options: lead, lead_deal, partner, card
​
partner_type
string
Filter by partner type. Options: referral, reseller

​
Response Schema

​
tags
array
Array of tag objects

​
Example Response

[
  {
    "id": 10,
    "uuid": "tag-uuid-123",
    "label": "High Priority",
    "background_color": "#EF4444",
    "text_color": "#FFFFFF",
    "association": "lead",
    "partner_type": "referral",
    "company_id": 123
  },
  {
    "id": 11,
    "label": "Enterprise",
    "background_color": "#8B5CF6",
    "text_color": "#FFFFFF",
    "association": "lead_deal"
  }
]

​
Notes

  • Requires API key with read_access permission
  • Tags provide visual organization and filtering capabilities
  • Different associations allow tags for different entity types