Skip to main content
GET
/
api
/
v1
/
categories
Get Categories
curl --request GET \
  --url https://app.journeybee.io/api/v1/categories \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 1,
    "uuid": "category-uuid-123",
    "label": "Technology",
    "partner_type": "referral",
    "company_id": 123,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  },
  {
    "id": 2,
    "label": "Healthcare",
    "partner_type": "referral"
  }
]

​
Authentication

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

​
Response Schema

​
categories
array
Array of category objects

​
Example Response

[
  {
    "id": 1,
    "uuid": "category-uuid-123",
    "label": "Technology",
    "partner_type": "referral",
    "company_id": 123,
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  },
  {
    "id": 2,
    "label": "Healthcare",
    "partner_type": "referral"
  }
]

​
Notes

  • Requires API key with read_access permission
  • Categories help organize partners by industry or business type
  • Used for filtering and reporting on partnership performance