Skip to content

API Reference / Transitions

List contract transitions

Returns a paged list of transitions for a contract, optionally scoped to the changes between two specific snapshots. Each page carries hydrated entities, so no follow-up GetTransitions is needed.

POST/contracts.v1.Contracts/ListTransitions

Request body

application/jsonRequired

Request for one page of a contract's transitions, optionally between a given pair of snapshots.

contractIdstring

Contract to list transitions from.

Format"byte" base64

cursor?string

Opaque pagination cursor from a previous ListTransitionsResponse. Empty for the first page.

filter?TransitionFilter

Optional filters applied before pagination.

Show attributes
fromSnapshotId?string

Optional filter: only transitions whose earlier snapshot is this one.

Format"int64"

toSnapshotId?string

Optional filter: only transitions whose later snapshot is this one.

Format"int64"

limit?integer

Maximum number of transitions to return. Server caps this at a service-defined upper bound.

Format"int32"

Response body

application/json

Success

nextCursor?string

Cursor to pass to fetch the next page. Empty when there are no more results.

transitions?array<Transition>

Full transitions for this page. A page carries the hydrated entities, not bare ids, so the caller needs no follow-up GetTransitions.

Show attributes
contractId?string

Contract this transition belongs to.

Format"byte" base64

createdAt?string

When the transition was created.

Format"date-time"

createdBy?string

Actor whose contract update triggered the evaluation that produced this transition. Unset for a background evaluation (a periodic re-evaluation sweep, or a SERVICE own-behalf actor).

Format"byte" base64

deletedAt?string

When the transition was soft-deleted, if it has been.

Format"date-time"

fromSnapshotId?string

Earlier snapshot in the pair this transition diffs.

Format"int64"

id?string

Opaque 16-byte transition identifier, base64-encoded in JSON.

Format"byte" base64

marketHashName?string

The item that changed between the two snapshots.

toSnapshotId?string

Later snapshot in the pair this transition diffs.

Format"int64"

type?string

Kind of change this transition represents.

Value in"TRANSITION_TYPE_ADD""TRANSITION_TYPE_REMOVE""TRANSITION_TYPE_UPDATE"

updatedAt?string

When the transition was last modified.

Format"date-time"

updatedBy?string

Same actor as created_by. A transition is insert-only, so the two are always stamped identically.

Format"byte" base64

workspaceId?string

Workspace the transition's contract belongs to.

Format"byte" base64

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/ListTransitions" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractId": "EBESExQVFhcYGRobHB0eHw==",
    "limit": 100,
    "cursor": "",
    "filter": {
      "fromSnapshotId": "6",
      "toSnapshotId": "7"
    }
  }'
{
  "transitions": [
    {
      "contractId": "EBESExQVFhcYGRobHB0eHw==",
      "fromSnapshotId": "6",
      "toSnapshotId": "7",
      "id": "dHJhbnNpdGlvbi0wMDAx",
      "type": "added",
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "createdAt": "2026-04-01T12:15:00Z",
      "updatedAt": "2026-04-01T12:15:00Z"
    }
  ],
  "nextCursor": ""
}