Skip to main content
GET
/
workflow-requests
/
{id}
/
history
Get Workflow Request History
curl --request GET \
  --url https://app.splox.io/api/v1/workflow-requests/{id}/history \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workflow_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "start_node_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "pending",
      "created_at": "2023-11-07T05:31:56Z",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "billing_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parent_node_execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parent_workflow_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "chat_id": "<string>",
      "payload": {},
      "metadata": {},
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "limit": 123,
    "next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}
Retrieves cursor-based paginated execution history for a workflow.

​
Usage

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://app.splox.io/api/v1/workflow-requests/{workflow_request_id}/history?limit=10"

​
Query Parameters

ParameterTypeDefaultDescription
limitinteger10Items per page (max: 100)
cursoruuid—Cursor from previous response for next page
searchstring—Search string to filter results

​
Response

{
  "data": [
    {
      "id": "0199f123-d60e-7ffd-9131-4cc5ab040ee8",
      "workflow_version_id": "0199e001-a23b-7c8d-1234-567890abcdef",
      "start_node_id": "0199e002-b34c-8d9e-2345-678901bcdef0",
      "status": "completed",
      "payload": { "text": "Hello", "chat_id": "..." },
      "started_at": "2025-10-22T12:15:32Z",
      "completed_at": "2025-10-22T12:15:47Z",
      "created_at": "2025-10-22T12:15:30Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "next_cursor": "0199f122-c50d-6eec-8020-3bb4a9f30dd7"
  }
}
Pagination: If next_cursor is present, pass it as ?cursor=<value> to get the next page. If next_cursor is absent, there are no more results.

​
Notes

Authentication required: Include Bearer token in Authorization header.

Authorizations

​
Authorization
string
header
required

API token generated from your Splox account settings. Create tokens at https://app.splox.io/account?tab=settings

Path Parameters

​
id
string<uuid>
required

Workflow request ID

Query Parameters

​
limit
integer
default:10

Items per page (default: 10, max: 100)

Required range: x <= 100
​
cursor
string<uuid>

Cursor for pagination (UUID of last item from previous page)

​
search
string

Search string to filter results

Response

200 - application/json

History retrieved successfully

​
data
object[]
​
pagination
object