Get item history

Audit trail of one item: submission, field changes, publishing, approval and archiving.

GET https://cotlet.dev/api/v1/dext/items/{item_id}/history

read

Returns the History tab of an item. Each entry has the time, the user or source and what changed. Use it to see who published an item before you unarchive it.

Parameters

Parameters: get_item_history
NameTypeDescription
item_id string required string Item ID from list_items.

Request

cURL
curl https://cotlet.dev/api/v1/dext/items/item_8c41d2/history \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("dext", "get_item_history", {"item_id":"item_8c41d2"})
Node.js
const result = await cotlet.call('dext', 'get_item_history', {"item_id":"item_8c41d2"});
CLI
cotlet call dext get_item_history --data '{"item_id":"item_8c41d2"}'

Example response

JSON

{
  "history": [
    {
      "at": "2026-10-09T08:14:00Z",
      "by": "Email upload",
      "action": "submitted"
    },
    {
      "at": "2026-10-09T08:16:00Z",
      "by": "Dext",
      "action": "extracted"
    },
    {
      "at": "2026-10-09T09:02:00Z",
      "by": "Dana Reyes",
      "action": "changed total_amount from 74.5 to 84.5"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.