Skip to main content
GET
/
v1
/
public
/
flowStates
cURL
curl --request GET \
  --url https://api.frigade.com/v1/public/flowStates \
  --header 'Authorization: Bearer <token>'
{
  "eligibleFlows": [
    {
      "flowSlug": "flow_abc",
      "flowName": "Onboarding Checklist",
      "flowType": "ANNOUNCEMENT",
      "data": {
        "steps": [
          {
            "id": "step_abc",
            "$state": {
              "completed": true,
              "skipped": true,
              "started": true,
              "visible": true,
              "blocked": true,
              "lastActionAt": "2024-09-01T00:00:00.000Z",
              "flowResponses": [
                {
                  "flowSlug": "flow_abc",
                  "actionType": "STARTED_STEP",
                  "stepId": "step-1",
                  "data": "{\"key\": \"value\"}",
                  "createdAt": "2024-01-01T00:00:00Z"
                }
              ]
            }
          }
        ]
      },
      "$state": {
        "currentStepId": "step_abc",
        "currentStepIndex": 1,
        "completed": true,
        "started": true,
        "skipped": true,
        "visible": true,
        "lastActionAt": "2024-09-01T00:00:00.000Z",
        "flowResponses": [
          {
            "flowSlug": "flow_abc",
            "actionType": "STARTED_STEP",
            "stepId": "step-1",
            "data": "{\"key\": \"value\"}",
            "createdAt": "2024-01-01T00:00:00Z"
          }
        ]
      },
      "version": 1
    }
  ],
  "ineligibleFlows": [
    "<string>"
  ]
}

Authorizations

​
Authorization
string
header
required

Authentication header of the form Bearer: <token>, where <token> is either your public or private API key. See when to use which

Query Parameters

​
userId
string
required

The ID of the user

​
groupId
string

Optional ID of the group

Response

200 - application/json

The Flow state for the User was found

​
eligibleFlows
object[]

List of Flows that the user is eligible for as well as the user's state in each Flow

​
ineligibleFlows
string[]

List of Flow IDs that the user is ineligible for (for instance if a Flow is turned off)