Skip to content

API Reference / Transitions

Fetch multiple contract transitions by ID

Returns the transitions matching the given IDs between two contract snapshots, alongside the IDs that did not resolve.

POST/contracts.v1.Contracts/GetTransitions

Request body

application/jsonRequired

Request for several transitions between one pair of a contract's snapshots, in one call.

contractIdstring

Contract the transitions belong to.

Format"byte" base64

fromSnapshotIdstring

Earlier snapshot in the pair the transitions diff.

Format"int64"

toSnapshotIdstring

Later snapshot in the pair the transitions diff.

Format"int64"

transitionIds?array<string>

Transition identifiers to fetch.

Response body

application/json

Success

notFoundIds?array<string>

Requested transition ids that did not resolve.

transitions?array<Transition>

The transitions that were found.

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/GetTransitions" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractId": "EBESExQVFhcYGRobHB0eHw==",
    "fromSnapshotId": "6",
    "toSnapshotId": "7",
    "transitionIds": [
      "dHJhbnNpdGlvbi0wMDAx",
      "dHJhbnNpdGlvbi0wMDAy"
    ]
  }'
{
  "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"
    }
  ],
  "notFoundIds": [
    "dHJhbnNpdGlvbi0wMDAy"
  ]
}