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.
/ contracts. v1. Contracts/ GetTransitionsRequest body
application/jsonRequired
Request for several transitions between one pair of a contract's snapshots, in one call.
contractIdstringContract the transitions belong to.
Format"byte" base64
fromSnapshotIdstringEarlier snapshot in the pair the transitions diff.
Format"int64"
toSnapshotIdstringLater 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?stringContract this transition belongs to.
Format"byte" base64
createdAt?stringWhen the transition was created.
Format"date-time"
createdBy?stringActor 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?stringWhen the transition was soft-deleted, if it has been.
Format"date-time"
fromSnapshotId?stringEarlier snapshot in the pair this transition diffs.
Format"int64"
id?stringOpaque 16-byte transition identifier, base64-encoded in JSON.
Format"byte" base64
marketHashName?stringThe item that changed between the two snapshots.
toSnapshotId?stringLater snapshot in the pair this transition diffs.
Format"int64"
type?stringKind of change this transition represents.
Value in"TRANSITION_"TRANSITION_"TRANSITION_
updatedAt?stringWhen the transition was last modified.
Format"date-time"
updatedBy?stringSame actor as created_by. A transition is insert-only, so the two are always stamped identically.
Format"byte" base64
workspaceId?stringWorkspace the transition's contract belongs to.
Format"byte" base64
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
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"
]
}'const res = await fetch("https://api.goldmine.to/contracts.v1.Contracts/GetTransitions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"fromSnapshotId": "6",
"toSnapshotId": "7",
"transitionIds": [
"dHJhbnNpdGlvbi0wMDAx",
"dHJhbnNpdGlvbi0wMDAy"
]
}),
});
const data = await res.json();body := strings.NewReader(`{
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"fromSnapshotId": "6",
"toSnapshotId": "7",
"transitionIds": [
"dHJhbnNpdGlvbi0wMDAx",
"dHJhbnNpdGlvbi0wMDAy"
]
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/contracts.v1.Contracts/GetTransitions", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/contracts.v1.Contracts/GetTransitions",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"contractId": "EBESExQVFhcYGRobHB0eHw==",
"fromSnapshotId": "6",
"toSnapshotId": "7",
"transitionIds": [
"dHJhbnNpdGlvbi0wMDAx",
"dHJhbnNpdGlvbi0wMDAy"
]
},
)
data = res.json(){
"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"
]
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}