Goldmine
Snapshots

Fetch multiple contract snapshots by ID

POST
/contracts.v1.Contracts/GetSnapshots

Returns the snapshots matching the given sequence numbers for a contract, alongside the IDs that did not resolve.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/contracts.v1.Contracts/GetSnapshots" \  -H "Content-Type: application/json" \  -d '{    "contractId": "EBESExQVFhcYGRobHB0eHw==",    "snapshotIds": [      "7",      "8"    ]  }'
{
  "snapshots": [
    {
      "contractId": "EBESExQVFhcYGRobHB0eHw==",
      "id": "7",
      "workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
      "added": "42",
      "updated": "5",
      "deleted": "3",
      "total": "118",
      "createdAt": "2026-04-01T12:15:00Z",
      "updatedAt": "2026-04-01T12:15:00Z"
    }
  ],
  "notFoundIds": [
    "8"
  ]
}
{
  "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."
}

GetSnapshot

Returns one evaluation snapshot of a contract, summarizing how many intents were added, updated, or removed and the total in effect. Snapshots bind an evaluation run to a fixed contract state.

ListSnapshots

Returns a paged list of evaluation snapshot sequence numbers for a contract, most recent first. Use GetSnapshot or GetSnapshots to hydrate the full records.