Get execution history (v2)

Retrieve execution history for the authenticated user with pagination support. Returns a lightweight history format with filtered prompt data (workflow removed from extra_pnginfo).

GET /api/history_v2

Get execution history (v2)

cURL

curl --request GET \
  --url https://cloud.comfy.org/api/history_v2 \
  --header 'X-API-Key: <api-key>'

200

{
  "history": [
    {
      "prompt_id": "<string>",
      "create_time": 123,
      "workflow_id": "<string>",
      "prompt": {
        "priority": 123,
        "prompt_id": "<string>",
        "extra_data": {}
      },
      "outputs": {},
      "status": {},
      "meta": {}
    }
  ]
}

Authorizations

X-API-Key · string · header · required

API key authentication. Generate an API key from your account settings at https://platform.comfy.org/profile/api-keys. Pass the key in the X-API-Key header.

Query Parameters

max_items · integer

Maximum number of items to return

offset · integer · default: 0

Starting position (default 0)

Response

200

application/json

Success - Execution history retrieved

Execution history response with history array. Returns an object with a "history" key containing an array of history entries. Each entry includes prompt_id as a property along with execution data.

history · object[] · required

Array of history entries ordered by creation time (newest first)

Show child attributes