Goldmine
Purchases

Fetch a single purchase by ID

POST
/contracts.v1.Contracts/GetPurchase

Returns the purchase identified by purchase_id within the caller's active workspace. Purchases track an item acquisition from attribution through marketplace completion and Steam trade.

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

application/json

curl -X POST "https://loading/contracts.v1.Contracts/GetPurchase" \  -H "Content-Type: application/json" \  -d '{    "purchaseId": "MDEyMzQ1Njc4OWFiY2RlZg=="  }'

{
  "purchase": {
    "id": "MDEyMzQ1Njc4OWFiY2RlZg==",
    "workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
    "contractId": "EBESExQVFhcYGRobHB0eHw==",
    "marketHashName": "AK-47 | Redline (Field-Tested)",
    "status": "PURCHASE_STATUS_TRADED",
    "version": "5",
    "listingPriceCents": "4200",
    "maxBuyPriceCents": "5000",
    "platformFeeCents": "800",
    "listingId": "csfloat-listing-8731",
    "listingAssetId": "29384710293",
    "marketplace": "csfloat",
    "accountName": "trader_steam_01",
    "createdAt": "2026-04-10T08:30:00Z",
    "updatedAt": "2026-04-10T09:12:00Z"
  }
}

{
  "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": "not_found",
  "message": "The requested resource does not exist in this workspace."
}
{
  "code": "resource_exhausted",
  "message": "The request was rate limited. Slow down and retry later."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}

CountPurchases

Returns the number of purchases in each status for the workspace, optionally filtered by contract_id. Drives the purchases list page status-tab counts without loading every purchase.

GetPurchases

Returns the purchases matching the given IDs within a workspace, alongside the IDs that did not resolve.