# List all deal segments
You can return a list with all of your deals’ segments. Use a returned URL to list all deals added to the segment.
GET
/deal-segments/
# Request
- CURL
- JavaScript
- PHP
- Python
curl -X GET -H "Authorization: Token <your_64_char_api_key>"
-H "Accept: */*; version=2"
"https://<your_app_subdomain>.user.com/api/public/deal-segments/"
# Response
{
"previous": null,
"results": [
{
"name": "New",
"description": "Purchasing process.\nProducts: X, Y, Z",
"deals": "https://<your_app_subdomain>.user.com/api/public/deal-segments/1038/deals/",
"id": 1038,
"object_count": 100,
"too_heavy": false,
"update_interval": 240,
"last_counted": "2024-10-11T10:12:32.661576Z",
"updated_at": "2024-10-11T10:12:32.661848Z"
},
{
"name": "Top selling",
"description": "Purchasing process.\nProducts: A, B, C",
"deals": "https://<your_app_subdomain>.user.com/api/public/deal-segments/1039/deals/",
"id": 1039,
"object_count": 100,
"too_heavy": false,
"update_interval": 240,
"last_counted": "2024-10-11T10:12:32.661576Z",
"updated_at": "2024-10-11T10:12:32.661848Z"
},
],
"next": null,
"count": 2
}