Skip to main content
GET
/
api
/
history_v2
Get execution history (v2)
curl --request GET \
  --url https://cloud.comfy.org/api/history_v2 \
  --header 'X-API-Key: <api-key>'
{
  "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://comfy.org/account. 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

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)