Skip to main content
GET
Returns both global categories (available to all users) and categories you’ve created. Categories are used to organize and filter leads based on their engagement or status.

Query Parameters

string
required
Your SmartLead API key

Response Fields

The response is an array of category objects, each containing:
number
Unique category identifier
string
Category name (e.g., “Interested”, “Not Interested”, “Meeting Booked”)
string
Sentiment classification of the category. Values: positive, negative, neutral
timestamp
ISO 8601 timestamp of when the category was created

Response Codes

Success
Categories retrieved successfully
Unauthorized
Invalid or missing API key
Internal Server Error
Server error occurred

Usage Notes

Categories are sorted by ID in ascending order. Global categories (available to all users) have lower IDs, while user-created categories have higher IDs.
Use the category ID when updating a lead’s category via the Update Lead Category endpoint. The sentiment type helps you filter leads for reporting and analytics.