List customer segments
GET/customer360/segments
Returns a paginated list of all customer segments ordered by most recently updated. Segments define rule-based groupings of customer profiles used for targeting journeys, campaigns, and personalisation.
Request
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | integer | No | Default: |
Responses
200 Paginated segment list
Content type application/json, object.
| Field | Type | Required | Description |
|---|---|---|---|
data | array of object · CustomerSegmentV1 | No | |
data[].id | integer | No | Auto-incremented primary key. |
data[].name | string | No | Segment display name. Example: |
data[].description | string, nullable | No | Human-readable description of the segment's membership criteria. |
data[].status | string | No | Lifecycle status. Only 'active' segments can power journeys. One of: |
data[].rules | array of object, nullable | No | Array of membership rule objects (field, operator, value). |
data[].created_by | integer, nullable | No | Tenant user ID who created this segment. |
data[].created_at | string (date-time) | No | Record creation timestamp. |
Example
{
"data": [
{
"id": 7,
"name": "Enterprise Fintech",
"description": "All enterprise-tier customers in the fintech industry.",
"status": "active",
"rules": [
{
"field": "attributes.tier",
"operator": "equals",
"value": "enterprise"
},
{
"field": "attributes.industry",
"operator": "equals",
"value": "fintech"
}
],
"created_by": 1,
"created_at": "2026-02-20T09:00:00Z"
}
]
}401 Unauthenticated
Example request
curl -X GET "https://{tenant}.faciotech.net/api/v1/customer360/segments" \
-H "Accept: application/json"