List item versions

curl --request GET \
  --url https://api.example.com/items/{id}/versions \
  --header 'Authorization: Bearer <token>'

{
  "versions": [
    {
      "id": "<string>",
      "item_id": "<string>",
      "version": 123,
      "properties": {},
      "created_at": "<string>",
      "device": "<string>"
    }
  ]
}

Items

List item versions

Returns the version-snapshot history for one item, newest first. Each snapshot carries the version number, the timestamp of the update that produced it, the full properties at that version, and the credential that wrote it.

Snapshots are thinned on a rolling schedule — every snapshot in the recent window, one per calendar day in the daily window, one per ISO week in the weekly window, dropped beyond. The most recent snapshot is never thinned. To restore from a version, fetch its properties and re-send them through PATCH /items/{id} — the restore becomes a new forward version. See Versions.

GET

items

{id}

versions

List item versions

curl --request GET \
  --url https://api.example.com/items/{id}/versions \
  --header 'Authorization: Bearer <token>'

{
  "versions": [
    {
      "id": "<string>",
      "item_id": "<string>",
      "version": 123,
      "properties": {},
      "created_at": "<string>",
      "device": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Pass an API key (marfa_k1_...) or OAuth access token (marfa_at_...)

Path Parameters

string

required

Response

Version history

versions

object[]

required

Show child attributes

Transition item state Get item metadata

Documentation Index

Authorizations

Path Parameters

Response