curl --request GET \
  --url 'https://sact.us.algolia.com/2/suggested-actions?target.appId=a&target.index=lorem&userId=lorem&excludeDismissed=true' \
  --header 'accept: application/json' \
  --header 'x-algolia-api-key: ALGOLIA_API_KEY' \
  --header 'x-algolia-application-id: ALGOLIA_APPLICATION_ID'

// Initialize the client
// Replace 'us' with your Algolia Application Region
const client = suggestedActionsClient('ALGOLIA_APPLICATION_ID', 'ALGOLIA_API_KEY', 'us');

// Call the API
const response = await client.listSuggestions({ targetAppId: 'MY_APP_ID' });


// print the response
console.log(response);

{
  "suggestions": [
    {
      "abTest": {
        "guidedActionSequence": {
          "actions": [
            {
              "description": "<string>",
              "openDashboardPage": {
                "url": "<string>"
              }
            }
          ],
          "description": "<string>"
        }
      },
      "adoptionDetectedAt": "2026-11-09T10:17:47Z",
      "completion": {
        "completedAt": "2026-11-09T10:17:47Z",
        "completedBy": "<string>",
        "source": "SOURCE_UNSPECIFIED"
      },
      "createdAt": "2026-11-09T10:17:47Z",
      "creation": {
        "createdBy": "<string>",
        "source": "SOURCE_UNSPECIFIED"
      },
      "description": "<string>",
      "directAdoption": {
        "guidedActionSequence": {
          "actions": [
            {
              "description": "<string>",
              "openDashboardPage": {
                "url": "<string>"
              }
            }
          ],
          "description": "<string>"
        }
      },
      "dismissedAt": "2026-11-09T10:17:47Z",
      "expiresAt": "2026-11-09T10:17:47Z",
      "id": "<string>",
      "metadata": {},
      "payload": {},
      "provenance": {
        "sources": [
          {
            "evidence": {},
            "id": "<string>",
            "kind": "EVIDENCE_SOURCE_KIND_UNSPECIFIED",
            "observedAt": "2026-11-09T10:17:47Z",
            "version": "<string>"
          }
        ]
      },
      "state": "SUGGESTION_STATE_UNSPECIFIED",
      "target": {
        "appId": "<string>",
        "index": "<string>"
      },
      "title": "<string>",
      "type": "SUGGESTION_TYPE_UNSPECIFIED",
      "withdrawnAt": "2026-11-09T10:17:47Z"
    }
  ]
}

{
  "status": 400,
  "message": "Bad request."
}

{
  "status": 401,
  "message": "Unauthorized."
}

{
  "status": 403,
  "message": "Forbidden."
}