Skip to main content
GET
/
api
/
v1
/
leads
/
fetch-categories
curl "https://server.smartlead.ai/api/v1/leads/fetch-categories?api_key=YOUR_KEY"

[
{
    "id": 1,
    "name": "Interested",
    "sentiment_type": "positive",
    "created_at": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": 2,
    "name": "Not Interested",
    "sentiment_type": "negative",
    "created_at": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": 3,
    "name": "Meeting Booked",
    "sentiment_type": "positive",
    "created_at": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": 789,
    "name": "Follow Up Later",
    "sentiment_type": "neutral",
    "created_at": "2025-11-20T14:22:00.000Z"
}
]
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

​
api_key
string
required
Your SmartLead API key
curl "https://server.smartlead.ai/api/v1/leads/fetch-categories?api_key=YOUR_KEY"

​
Response Fields

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

​
Response Codes

​
200
Success
Categories retrieved successfully
​
401
Unauthorized
Invalid or missing API key
​
500
Internal Server Error
Server error occurred
[
{
    "id": 1,
    "name": "Interested",
    "sentiment_type": "positive",
    "created_at": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": 2,
    "name": "Not Interested",
    "sentiment_type": "negative",
    "created_at": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": 3,
    "name": "Meeting Booked",
    "sentiment_type": "positive",
    "created_at": "2024-01-15T10:30:00.000Z"
  },
  {
    "id": 789,
    "name": "Follow Up Later",
    "sentiment_type": "neutral",
    "created_at": "2025-11-20T14:22:00.000Z"
}
]

​
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.