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>'
{
  "history": [
    {
      "id": "0199f123-d60e-7ffd-9131-4cc5ab040ee8",
      "workflow_version_id": "0199e001-a23b-7c8d-1234-567890abcdef",
      "start_node_id": "0199e002-b34c-8d9e-2345-678901bcdef0",
      "status": "completed",
      "created_at": "2025-10-22T12:15:30Z",
      "user_id": "0199d001-c45d-9e0f-3456-789012cdef01",
      "parent_node_execution_id": null,
      "parent_workflow_request_id": "0199f123-d60e-7ffd-9131-4cc5ab040ee8",
      "query": {
        "user_id": "12345",
        "event": "user.signup",
        "email": "[email protected]"
      },
      "iteration_array": null,
      "iteration_data": null,
      "files": [],
      "output": {
        "result": "success",
        "user_created": true,
        "welcome_email_sent": true
      },
      "metadata": {},
      "started_at": "2025-10-22T12:15:32Z",
      "completed_at": "2025-10-22T12:15:47Z"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "total_pages": 123
  }
}
Retrieves paginated execution history for a workflow request.

Usage

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

Query Parameters

  • page (optional) - Page number, default: 1
  • limit (optional) - Items per page, default: 20, max: 100

Response

{
  "history": [
    {
      "id": "0199f123-d60e-7ffd-9131-4cc5ab040ee8",
      "status": "completed",
      "created_at": "2025-10-22T12:15:30Z",
      "started_at": "2025-10-22T12:15:32Z",
      "completed_at": "2025-10-22T12:15:47Z",
      "query": {
        "event": "user.signup",
        "email": "[email protected]"
      },
      "output": {
        "result": "success"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "total_pages": 3
  }
}

Use Cases

  • Execution logs - View past executions
  • Performance tracking - Analyze execution times
  • Debugging - Find failed executions
  • Auditing - Track workflow usage

Notes

Authentication required: Include Bearer token in Authorization header

Authorizations

Authorization
string
header
required

JWT token from Splox account

Path Parameters

id
string<uuid>
required

Workflow request ID

Query Parameters

page
integer
default:1

Page number

limit
integer
default:20

Items per page

Required range: x <= 100

Response

200 - application/json

History retrieved successfully

history
object[]
pagination
object