Skip to content

List customer journeys

GET/customer360/journeys

Returns a paginated list of customer lifecycle journeys ordered by most recently updated, with their linked segment. Journeys define the automated experience a customer receives when they match a segment and trigger rules.

Request

Query parameters

NameTypeRequiredDescription
pageintegerNo

Default: 1

Responses

200 Paginated journey list with segment relations

Content type application/json, object.

FieldTypeRequiredDescription
dataarray of object · CustomerJourneyV1No
data[].idintegerNo

Auto-incremented primary key.

data[].namestringNo

Journey name.

Example: "Enterprise Onboarding"

data[].descriptionstring, nullableNo

Optional description of the journey's goals.

data[].segment_idinteger, nullableNo

ID of the segment that qualifies customers for this journey.

Example: 7

data[].statusstringNo

Lifecycle status. Only 'active' journeys enrol new customers.

One of: "draft", "active", "archived" · Example: "active"

data[].trigger_rulesarray of object, nullableNo

Entry trigger rule objects (event + conditions).

data[].export_targetsarray of object, nullableNo

Communication channel and template configuration objects.

data[].created_byinteger, nullableNo

Tenant user ID who created this journey.

data[].created_atstring (date-time)No

Record creation timestamp.

Example

{
  "data": [
    {
      "id": 5,
      "name": "Enterprise Onboarding",
      "description": "30-day onboarding journey for enterprise accounts.",
      "segment_id": 7,
      "status": "active",
      "trigger_rules": [
        {
          "event": "profile.created",
          "condition": {
            "tier": "enterprise"
          }
        }
      ],
      "export_targets": [
        {
          "channel": "email",
          "template": "onboarding_welcome"
        }
      ],
      "created_by": 1,
      "created_at": "2026-03-01T08:00:00Z"
    }
  ]
}

401 Unauthenticated

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/customer360/journeys" \
  -H "Accept: application/json"
Loading