Segments

List Segments

GET /api/v2/my-data/pois/segments/index

Lists every segment available to the authenticated user’s company. Each row is a { value, text } pair suitable for a select control.

Auth: bearer token + Accept: application/json. Rate limit: read bucket (120 requests/min).

Query parameters

Field	Type	Required	Description
`search`	string	No	Optional free-text filter on the segment name (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/my-data/pois/segments/index" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/my-data/pois/segments/index",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
)
segments = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/my-data/pois/segments/index",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const segments = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resource fetched successfully.",
  "data": [
    {
      "value": 123,
      "text": "Demo Segment"
    }
  ]
}

Failed requests use the shared error envelope - see Errors.