Skip to content

API Reference / Transitions

Fetch a single contract transition by ID

Returns one transition between two contract evaluation snapshots, recording how a single item changed (added, updated, or removed) from one snapshot to the next.

POST/contracts.v1.Contracts/GetTransition

Request body

application/jsonRequired

Request for one transition between two snapshots of a contract.

contractIdstring

Contract the transition belongs to.

Format"byte" base64

fromSnapshotIdstring

Earlier snapshot in the pair the transition diffs.

Format"int64"

toSnapshotIdstring

Later snapshot in the pair the transition diffs.

Format"int64"

transitionIdstring

Transition identifier.

Format"byte" base64

Response body

application/json

Success

transition?Transition

The requested transition.

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/GetTransition" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractId": "EBESExQVFhcYGRobHB0eHw==",
    "fromSnapshotId": "6",
    "toSnapshotId": "7",
    "transitionId": "dHJhbnNpdGlvbi0wMDAx"
  }'
{
  "transition": {
    "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"
  }
}