List Flow Subscriptions

List all flow subscriptions for your team. You can filter by recipient email and flow trigger keyword.

GET https://api.notifiedby.com/v1/flows/subscriptions/

Query Parameters:

Parameter	Required	Description
email	No	Filter subscriptions by recipient email address.
flow_trigger	No	Filter subscriptions by flow trigger keyword.

Success Response (200):

[
    {
        "id": 42,
        "flow_name": "Welcome Signup Flow",
        "flow_trigger": "WELCOME_SIGNUP",
        "recipient_email": "user@example.com",
        "status": "active",
        "current_step_order": 2,
        "next_send_date": "2026-02-18T10:00:00Z",
        "created_at": "2026-02-17T09:00:00Z",
        "updated_at": "2026-02-17T10:00:00Z"
    }
]

Each subscription object contains:

Field	Description
id	The subscription ID.
flow_name	The human-readable name of the flow.
flow_trigger	The trigger keyword of the flow.
recipient_email	The subscribed recipient’s email address.
status	One of active, completed, or cancelled.
current_step_order	The order number of the step the recipient is currently on.
next_send_date	When the next step in the sequence will be processed.
created_at	When the subscription was created.
updated_at	When the subscription was last updated.

Example with curl:

curl -X GET "https://api.notifiedby.com/v1/flows/subscriptions/?email=user@example.com" \
    -H "Authorization: Api-Key YOUR_API_KEY"