# 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
}