Get a Specific Version of a Flow

curl --request GET \
  --url https://api-{dc}.moengage.com/v5/flows/{flow_id}/versions/{version_id} \
  --header 'Authorization: Basic <encoded-value>'

{
  "response_id": "abc-102",
  "type": "flow",
  "data": {
    "flow_id": "69f1de84f9e401a2d7d9a931",
    "name": "Welcome journey",
    "status": "RETIRED",
    "archived": false,
    "delivery_type": "EVENT_TRIGGERED",
    "tags": [
      "onboarding"
    ],
    "created_at": "2026-01-05T10:00:00Z",
    "updated_at": "2026-01-20T09:30:00Z",
    "published_at": "2026-01-06T08:00:00Z",
    "created_by": "[email protected]",
    "published_by": "[email protected]",
    "global_control_group_enabled": false,
    "active_version_name": "Version 1",
    "versions": [
      {
        "version_id": "7a02ef95f9e401a2d7d9aa42",
        "version_name": "Version 1",
        "version_no": 1,
        "status": "RETIRED"
      }
    ],
    "settings": {
      "control_group": {
        "enabled": false
      },
      "frequency_capping": {
        "ignore": false,
        "ignore_and_count": false
      },
      "bypass_dnd": false
    },
    "attribution": {
      "click_track_hours": 24,
      "impression_track_hours": 24
    },
    "conversion_goal_details": {
      "primary_goal": {
        "event": "Purchase",
        "goal_name": "Made a purchase"
      },
      "secondary_goals": [],
      "revenue_tracking": true,
      "revenue_attribute": "amount",
      "revenue_currency": "USD",
      "exit_on_conversion": false
    },
    "structure": {
      "nodes": [
        {
          "stage_id": "n1",
          "type": "TRIGGER",
          "sub_type": "EVENT",
          "parent_stage_id": null,
          "child_stage_ids": [
            "n2"
          ],
          "label": "App Opened",
          "config": {
            "schedule": {
              "delivery": "one_time",
              "start_time": "2026-01-06T08:00:00Z",
              "timezone": "Asia/Kolkata"
            },
            "segmentation": {
              "audience_type": "all_users"
            }
          }
        },
        {
          "stage_id": "n2",
          "type": "ACTION",
          "sub_type": "EMAIL",
          "parent_stage_id": "n1",
          "child_stage_ids": [],
          "label": "Welcome email",
          "config": {
            "campaign_id": "69f1de84f9e401a2d7d9a999",
            "channel": "EMAIL",
            "campaign_name": "Welcome email"
          }
        }
      ]
    }
  }
}

{
  "response_id": "abc-101",
  "error": {
    "code": "VALIDATION_FAILED",
    "target": "request",
    "message": "One or more request parameters failed validation.",
    "details": [
      {
        "target": "request",
        "message": "Check the request parameters and try again."
      }
    ]
  }
}

{
  "response_id": "abc-101",
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing credentials.",
    "details": []
  }
}

{
  "response_id": "abc-450",
  "error": {
    "code": "FORBIDDEN",
    "target": "permission",
    "message": "You do not have the required permission for this operation.",
    "details": [
      {
        "target": "permission",
        "message": "Required permission: campaigns:view"
      }
    ]
  }
}

{
  "response_id": "abc-100",
  "error": {
    "code": "NOT_FOUND",
    "target": "flow",
    "message": "Flow not found.",
    "details": [
      {
        "target": "flow_id",
        "message": "Flow not found."
      }
    ]
  }
}

{
  "response_id": "abc-101",
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded for app key.",
    "details": []
  }
}

{
  "response_id": "abc-101",
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error.",
    "details": []
  }
}

GET

flows

{flow_id}

versions

{version_id}

Get a Specific Version of a Flow

curl --request GET \
  --url https://api-{dc}.moengage.com/v5/flows/{flow_id}/versions/{version_id} \
  --header 'Authorization: Basic <encoded-value>'

{
  "response_id": "abc-102",
  "type": "flow",
  "data": {
    "flow_id": "69f1de84f9e401a2d7d9a931",
    "name": "Welcome journey",
    "status": "RETIRED",
    "archived": false,
    "delivery_type": "EVENT_TRIGGERED",
    "tags": [
      "onboarding"
    ],
    "created_at": "2026-01-05T10:00:00Z",
    "updated_at": "2026-01-20T09:30:00Z",
    "published_at": "2026-01-06T08:00:00Z",
    "created_by": "[email protected]",
    "published_by": "[email protected]",
    "global_control_group_enabled": false,
    "active_version_name": "Version 1",
    "versions": [
      {
        "version_id": "7a02ef95f9e401a2d7d9aa42",
        "version_name": "Version 1",
        "version_no": 1,
        "status": "RETIRED"
      }
    ],
    "settings": {
      "control_group": {
        "enabled": false
      },
      "frequency_capping": {
        "ignore": false,
        "ignore_and_count": false
      },
      "bypass_dnd": false
    },
    "attribution": {
      "click_track_hours": 24,
      "impression_track_hours": 24
    },
    "conversion_goal_details": {
      "primary_goal": {
        "event": "Purchase",
        "goal_name": "Made a purchase"
      },
      "secondary_goals": [],
      "revenue_tracking": true,
      "revenue_attribute": "amount",
      "revenue_currency": "USD",
      "exit_on_conversion": false
    },
    "structure": {
      "nodes": [
        {
          "stage_id": "n1",
          "type": "TRIGGER",
          "sub_type": "EVENT",
          "parent_stage_id": null,
          "child_stage_ids": [
            "n2"
          ],
          "label": "App Opened",
          "config": {
            "schedule": {
              "delivery": "one_time",
              "start_time": "2026-01-06T08:00:00Z",
              "timezone": "Asia/Kolkata"
            },
            "segmentation": {
              "audience_type": "all_users"
            }
          }
        },
        {
          "stage_id": "n2",
          "type": "ACTION",
          "sub_type": "EMAIL",
          "parent_stage_id": "n1",
          "child_stage_ids": [],
          "label": "Welcome email",
          "config": {
            "campaign_id": "69f1de84f9e401a2d7d9a999",
            "channel": "EMAIL",
            "campaign_name": "Welcome email"
          }
        }
      ]
    }
  }
}

{
  "response_id": "abc-101",
  "error": {
    "code": "VALIDATION_FAILED",
    "target": "request",
    "message": "One or more request parameters failed validation.",
    "details": [
      {
        "target": "request",
        "message": "Check the request parameters and try again."
      }
    ]
  }
}

{
  "response_id": "abc-101",
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing credentials.",
    "details": []
  }
}

{
  "response_id": "abc-450",
  "error": {
    "code": "FORBIDDEN",
    "target": "permission",
    "message": "You do not have the required permission for this operation.",
    "details": [
      {
        "target": "permission",
        "message": "Required permission: campaigns:view"
      }
    ]
  }
}

{
  "response_id": "abc-100",
  "error": {
    "code": "NOT_FOUND",
    "target": "flow",
    "message": "Flow not found.",
    "details": [
      {
        "target": "flow_id",
        "message": "Flow not found."
      }
    ]
  }
}

{
  "response_id": "abc-101",
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded for app key.",
    "details": []
  }
}

{
  "response_id": "abc-101",
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error.",
    "details": []
  }
}

Rate Limits

The rate limits are at the workspace level. A maximum of 10 requests per second, 100 requests per minute, and 6,000 requests per hour are allowed per workspace.

Authorizations

Authorization

string

header

required

Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format username:password.

Username: Use your MoEngage Workspace ID (also known as the App ID). Find it in the MoEngage dashboard at Settings > Account > API keys.
Password: Use an API key from Settings > Account > API keys.

Refer to API Key Dashboard for details on creating and managing API keys.

Headers

X-MOE-Request-Id

string

Client-supplied trace ID. The server echoes it in the X-MOE-Request-Id response header and in response_id. If you omit it, the server generates one.

Path Parameters

flow_id

string

required

The 24-character ID of the flow. This must be the flow's own ID, not a version ID; passing a version ID returns 400.

Pattern: ^[a-f0-9]{24}$

Example:

"6a3b09c938da57c8f5838880"

version_id

string

required

The 24-character ID of a specific version of the flow. Must belong to flow_id.

Pattern: ^[a-f0-9]{24}$

Response

Flow version found.

response_id

string

Echo of the X-MOE-Request-Id that you supplied. When you omit it, MoEngage returns the first 12 characters of a system-generated UUID.

type

enum<string>

The type of resource the response describes.

Available options:

flow

data

object

Full single-flow detail. Carries every FlowSummary field plus the version list, publish metadata, settings, attribution, conversion goal, and its stages.

Show child attributes

​Rate Limits

Authorizations

Headers

Path Parameters

Response

Rate Limits