Skip to content

API Reference / Purchases

Find purchases and inventory items by part of their id

Returns at most 3 purchases and 3 inventory items in the workspace whose id contains the given hex fragment, ids ending in the fragment first, then newest first. A whole id is served the same way.

POST/contracts.v1.Contracts/GetRecordReferencesByIDFragment

Request body

application/jsonRequired

Request for the purchases and inventory items in the caller's workspace whose id contains a hex fragment.

idFragment?string

4 to 32 hexadecimal characters, case-insensitive, dashes ignored. Anything else is rejected with invalid_argument.

objectTypes?array<string>

Kinds to search: OBJECT_TYPE_CONTRACTS_PURCHASE and OBJECT_TYPE_CONTRACTS_INVENTORY_ITEM. Empty searches both. Any other value is rejected with invalid_argument.

Value in"OBJECT_TYPE_PROXIES_PROXY""OBJECT_TYPE_SCHEDULER_JOB""OBJECT_TYPE_CONTRACTS_CONTRACT""OBJECT_TYPE_CONTRACTS_SNAPSHOT""OBJECT_TYPE_CONTRACTS_INTENT""OBJECT_TYPE_CONTRACTS_TRANSITION""OBJECT_TYPE_STEAM_ACCOUNT""OBJECT_TYPE_COUNTERSTRIKE_ITEM""OBJECT_TYPE_ACCOUNTS_USER""OBJECT_TYPE_ACCOUNTS_WORKSPACE""OBJECT_TYPE_ACCOUNTS_MEMBERSHIP""OBJECT_TYPE_CSFLOAT_ACCOUNT""OBJECT_TYPE_CSFLOAT_OFFER""OBJECT_TYPE_CSFLOAT_ORDER""OBJECT_TYPE_CSFLOAT_TARGET""OBJECT_TYPE_CSFLOAT_TRADE""OBJECT_TYPE_CONNECTORS_CONNECTOR""OBJECT_TYPE_CONNECTORS_CONNECTOR_STREAM""OBJECT_TYPE_CONTRACTS_PURCHASE""OBJECT_TYPE_CONTRACTS_INVENTORY_ITEM""OBJECT_TYPE_CONTRACTS_ASSET_ID_LINK""OBJECT_TYPE_PROXIES_PROXY_POOL""OBJECT_TYPE_PROXIES_PROXY_ASSIGNMENT""OBJECT_TYPE_AUDIT_ENTRY""OBJECT_TYPE_CSFLOAT_MARKET_CONFIG""OBJECT_TYPE_CONTRACTS_GLOBAL_POOL_ITEM""OBJECT_TYPE_STEAM_TRADE_OFFER""OBJECT_TYPE_ACCOUNTS_API_KEY""OBJECT_TYPE_PROXIES_PROVIDER""OBJECT_TYPE_PROXIES_POOL""OBJECT_TYPE_PROXIES_SESSION""OBJECT_TYPE_PROXIES_ASSIGNMENT""OBJECT_TYPE_ACCOUNTS_WORKSPACE_KEY""OBJECT_TYPE_STEAM_CHAT_MESSAGE""OBJECT_TYPE_STEAM_FRIENDS_LIST""OBJECT_TYPE_STEAM_PERSONA_STATE""OBJECT_TYPE_STEAM_INVENTORY_ITEM""OBJECT_TYPE_MARKET_SELLING_LISTING""OBJECT_TYPE_MARKET_SELLING_TRADE""OBJECT_TYPE_STEAM_CONFIRMATION""OBJECT_TYPE_PROXIES_SESSION_HEALTH""OBJECT_TYPE_STEAM_CHAT_READ_CURSOR""OBJECT_TYPE_CONTRACTS_BLUEPRINT""OBJECT_TYPE_CONTRACTS_ACCOUNT_GROUP""OBJECT_TYPE_CONTRACTS_FILTER_SET""OBJECT_TYPE_CONNECTORS_CONNECTOR_STREAM_STATE""OBJECT_TYPE_ACCOUNTS_AUTHENTICATION_IDENTITY""OBJECT_TYPE_ACCOUNTS_AUTHENTICATION_SESSION""OBJECT_TYPE_ACCOUNTS_CREDENTIAL""OBJECT_TYPE_ACCOUNTS_VERIFICATION_TOKEN""OBJECT_TYPE_ACCOUNTS_TOTP""OBJECT_TYPE_ACCOUNTS_TOTP_BACKUP_CODE""OBJECT_TYPE_ACCOUNTS_PASSKEY""OBJECT_TYPE_ACCOUNTS_ALLOWLIST_ENTRY""OBJECT_TYPE_PROXIES_RENEWAL""OBJECT_TYPE_PROXIES_REMEDIATION""OBJECT_TYPE_PROXIES_ASSIGNMENT_REBOUND""OBJECT_TYPE_CSFLOAT_ATTEMPT""OBJECT_TYPE_CSFLOAT_AUCTION_BID""OBJECT_TYPE_CSFLOAT_TRANSACTION""OBJECT_TYPE_CSFLOAT_WATCHED_LISTING""OBJECT_TYPE_CSFLOAT_SOLD_LISTING""OBJECT_TYPE_ACCOUNTS_ADMISSION_INVITER""OBJECT_TYPE_ACCOUNTS_ADMISSION_CODE""OBJECT_TYPE_ACCOUNTS_ADMISSION_CLAIM""OBJECT_TYPE_BILLING_PROFILE""OBJECT_TYPE_BILLING_TRANSACTION""OBJECT_TYPE_STEAM_CHAT_SEND_OUTCOME""OBJECT_TYPE_ANALYTICS_MARKET_OBSERVATION_BATCH""OBJECT_TYPE_CONTRACTS_INTENT_ROLLUP_REBUILT""OBJECT_TYPE_COUNTERSTRIKE_CATALOG_BATCH""OBJECT_TYPE_ACCOUNTS_READ_MODEL_CHANGED""OBJECT_TYPE_ANALYTICS_CATALOG_PROJECTION_BATCH""OBJECT_TYPE_ANALYTICS_MARKET_SALE_BATCH""OBJECT_TYPE_STEAM_CATALOG_PROJECTION_BATCH""OBJECT_TYPE_STEAM_PERSONA_SNAPSHOT_BATCH""OBJECT_TYPE_COUNTERSTRIKE_CATALOG_PROJECTION_PAGE""OBJECT_TYPE_STEAM_ACCOUNT_TELEMETRY""OBJECT_TYPE_STEAM_CHAT_TYPING_NOTIFICATION""OBJECT_TYPE_STEAM_TRADE_OFFER_SEND_OUTCOME""OBJECT_TYPE_CONTRACTS_POSITION""OBJECT_TYPE_CONTRACTS_WORKSPACE_MARKETPLACE""OBJECT_TYPE_MARKETS_MARKET_ACCOUNT""OBJECT_TYPE_MARKETS_BUY_ATTEMPT""OBJECT_TYPE_MARKETS_HALT""OBJECT_TYPE_CONTRACTS_ALLOWANCE""OBJECT_TYPE_STEAM_RECEIVED_ITEM""OBJECT_TYPE_MARKETS_POSITION""OBJECT_TYPE_MARKETS_MARKET_CONNECTION""OBJECT_TYPE_MARKETS_WORKSPACE_MARKET_SETTINGS""OBJECT_TYPE_MARKETS_SETTING_OVERRIDE""OBJECT_TYPE_PROXIES_PROVIDER_CREDENTIALS_REVEAL""OBJECT_TYPE_ANALYTICS_PROXY_REQUEST_BATCH""OBJECT_TYPE_STEAM_ACCOUNT_CREDENTIALS_REVEAL""OBJECT_TYPE_MARKETS_SCRAPING_ACCOUNT""OBJECT_TYPE_STEAM_ACCOUNT_IMPORT""OBJECT_TYPE_MARKETS_ORDER_HOLD""OBJECT_TYPE_MARKETS_PLAN_DECISION""OBJECT_TYPE_STEAM_INVENTORY_DEPARTURE""OBJECT_TYPE_CONTRACTS_WORKSPACE_STOP""OBJECT_TYPE_STEAM_WORKSPACE_QUOTA_OVERRIDE""OBJECT_TYPE_MARKETS_READER_SWITCH""OBJECT_TYPE_MARKETS_BUYING_SWITCH""OBJECT_TYPE_MARKETS_LISTINGS_SEEN""OBJECT_TYPE_CONTRACTS_SALE""OBJECT_TYPE_CONTRACTS_VALUATION_BASIS""OBJECT_TYPE_STEAM_WORKSPACE_API_KEY"

Response body

application/json

Success

records?array<RecordReference>

Purchases first, then inventory items. Within a kind, ids ending in the fragment first, then newest first.

Show attributes
id?string

The record's full 16-byte id.

Format"byte" base64

inventoryItemStatus?string

An inventory item's status, so a sold item opens as a sale. Unset for a purchase.

Value in"INVENTORY_ITEM_STATUS_PENDING_TRADE""INVENTORY_ITEM_STATUS_IN_INVENTORY""INVENTORY_ITEM_STATUS_LISTED""INVENTORY_ITEM_STATUS_SOLD""INVENTORY_ITEM_STATUS_LOST"

marketHashName?string

The record's item name, for the label.

objectType?string

The record's kind: OBJECT_TYPE_CONTRACTS_PURCHASE or OBJECT_TYPE_CONTRACTS_INVENTORY_ITEM.

Value in"OBJECT_TYPE_PROXIES_PROXY""OBJECT_TYPE_SCHEDULER_JOB""OBJECT_TYPE_CONTRACTS_CONTRACT""OBJECT_TYPE_CONTRACTS_SNAPSHOT""OBJECT_TYPE_CONTRACTS_INTENT""OBJECT_TYPE_CONTRACTS_TRANSITION""OBJECT_TYPE_STEAM_ACCOUNT""OBJECT_TYPE_COUNTERSTRIKE_ITEM""OBJECT_TYPE_ACCOUNTS_USER""OBJECT_TYPE_ACCOUNTS_WORKSPACE""OBJECT_TYPE_ACCOUNTS_MEMBERSHIP""OBJECT_TYPE_CSFLOAT_ACCOUNT""OBJECT_TYPE_CSFLOAT_OFFER""OBJECT_TYPE_CSFLOAT_ORDER""OBJECT_TYPE_CSFLOAT_TARGET""OBJECT_TYPE_CSFLOAT_TRADE""OBJECT_TYPE_CONNECTORS_CONNECTOR""OBJECT_TYPE_CONNECTORS_CONNECTOR_STREAM""OBJECT_TYPE_CONTRACTS_PURCHASE""OBJECT_TYPE_CONTRACTS_INVENTORY_ITEM""OBJECT_TYPE_CONTRACTS_ASSET_ID_LINK""OBJECT_TYPE_PROXIES_PROXY_POOL""OBJECT_TYPE_PROXIES_PROXY_ASSIGNMENT""OBJECT_TYPE_AUDIT_ENTRY""OBJECT_TYPE_CSFLOAT_MARKET_CONFIG""OBJECT_TYPE_CONTRACTS_GLOBAL_POOL_ITEM""OBJECT_TYPE_STEAM_TRADE_OFFER""OBJECT_TYPE_ACCOUNTS_API_KEY""OBJECT_TYPE_PROXIES_PROVIDER""OBJECT_TYPE_PROXIES_POOL""OBJECT_TYPE_PROXIES_SESSION""OBJECT_TYPE_PROXIES_ASSIGNMENT""OBJECT_TYPE_ACCOUNTS_WORKSPACE_KEY""OBJECT_TYPE_STEAM_CHAT_MESSAGE""OBJECT_TYPE_STEAM_FRIENDS_LIST""OBJECT_TYPE_STEAM_PERSONA_STATE""OBJECT_TYPE_STEAM_INVENTORY_ITEM""OBJECT_TYPE_MARKET_SELLING_LISTING""OBJECT_TYPE_MARKET_SELLING_TRADE""OBJECT_TYPE_STEAM_CONFIRMATION""OBJECT_TYPE_PROXIES_SESSION_HEALTH""OBJECT_TYPE_STEAM_CHAT_READ_CURSOR""OBJECT_TYPE_CONTRACTS_BLUEPRINT""OBJECT_TYPE_CONTRACTS_ACCOUNT_GROUP""OBJECT_TYPE_CONTRACTS_FILTER_SET""OBJECT_TYPE_CONNECTORS_CONNECTOR_STREAM_STATE""OBJECT_TYPE_ACCOUNTS_AUTHENTICATION_IDENTITY""OBJECT_TYPE_ACCOUNTS_AUTHENTICATION_SESSION""OBJECT_TYPE_ACCOUNTS_CREDENTIAL""OBJECT_TYPE_ACCOUNTS_VERIFICATION_TOKEN""OBJECT_TYPE_ACCOUNTS_TOTP""OBJECT_TYPE_ACCOUNTS_TOTP_BACKUP_CODE""OBJECT_TYPE_ACCOUNTS_PASSKEY""OBJECT_TYPE_ACCOUNTS_ALLOWLIST_ENTRY""OBJECT_TYPE_PROXIES_RENEWAL""OBJECT_TYPE_PROXIES_REMEDIATION""OBJECT_TYPE_PROXIES_ASSIGNMENT_REBOUND""OBJECT_TYPE_CSFLOAT_ATTEMPT""OBJECT_TYPE_CSFLOAT_AUCTION_BID""OBJECT_TYPE_CSFLOAT_TRANSACTION""OBJECT_TYPE_CSFLOAT_WATCHED_LISTING""OBJECT_TYPE_CSFLOAT_SOLD_LISTING""OBJECT_TYPE_ACCOUNTS_ADMISSION_INVITER""OBJECT_TYPE_ACCOUNTS_ADMISSION_CODE""OBJECT_TYPE_ACCOUNTS_ADMISSION_CLAIM""OBJECT_TYPE_BILLING_PROFILE""OBJECT_TYPE_BILLING_TRANSACTION""OBJECT_TYPE_STEAM_CHAT_SEND_OUTCOME""OBJECT_TYPE_ANALYTICS_MARKET_OBSERVATION_BATCH""OBJECT_TYPE_CONTRACTS_INTENT_ROLLUP_REBUILT""OBJECT_TYPE_COUNTERSTRIKE_CATALOG_BATCH""OBJECT_TYPE_ACCOUNTS_READ_MODEL_CHANGED""OBJECT_TYPE_ANALYTICS_CATALOG_PROJECTION_BATCH""OBJECT_TYPE_ANALYTICS_MARKET_SALE_BATCH""OBJECT_TYPE_STEAM_CATALOG_PROJECTION_BATCH""OBJECT_TYPE_STEAM_PERSONA_SNAPSHOT_BATCH""OBJECT_TYPE_COUNTERSTRIKE_CATALOG_PROJECTION_PAGE""OBJECT_TYPE_STEAM_ACCOUNT_TELEMETRY""OBJECT_TYPE_STEAM_CHAT_TYPING_NOTIFICATION""OBJECT_TYPE_STEAM_TRADE_OFFER_SEND_OUTCOME""OBJECT_TYPE_CONTRACTS_POSITION""OBJECT_TYPE_CONTRACTS_WORKSPACE_MARKETPLACE""OBJECT_TYPE_MARKETS_MARKET_ACCOUNT""OBJECT_TYPE_MARKETS_BUY_ATTEMPT""OBJECT_TYPE_MARKETS_HALT""OBJECT_TYPE_CONTRACTS_ALLOWANCE""OBJECT_TYPE_STEAM_RECEIVED_ITEM""OBJECT_TYPE_MARKETS_POSITION""OBJECT_TYPE_MARKETS_MARKET_CONNECTION""OBJECT_TYPE_MARKETS_WORKSPACE_MARKET_SETTINGS""OBJECT_TYPE_MARKETS_SETTING_OVERRIDE""OBJECT_TYPE_PROXIES_PROVIDER_CREDENTIALS_REVEAL""OBJECT_TYPE_ANALYTICS_PROXY_REQUEST_BATCH""OBJECT_TYPE_STEAM_ACCOUNT_CREDENTIALS_REVEAL""OBJECT_TYPE_MARKETS_SCRAPING_ACCOUNT""OBJECT_TYPE_STEAM_ACCOUNT_IMPORT""OBJECT_TYPE_MARKETS_ORDER_HOLD""OBJECT_TYPE_MARKETS_PLAN_DECISION""OBJECT_TYPE_STEAM_INVENTORY_DEPARTURE""OBJECT_TYPE_CONTRACTS_WORKSPACE_STOP""OBJECT_TYPE_STEAM_WORKSPACE_QUOTA_OVERRIDE""OBJECT_TYPE_MARKETS_READER_SWITCH""OBJECT_TYPE_MARKETS_BUYING_SWITCH""OBJECT_TYPE_MARKETS_LISTINGS_SEEN""OBJECT_TYPE_CONTRACTS_SALE""OBJECT_TYPE_CONTRACTS_VALUATION_BASIS""OBJECT_TYPE_STEAM_WORKSPACE_API_KEY"

curl -X POST "https://api.goldmine.to/contracts.v1.Contracts/GetRecordReferencesByIDFragment" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idFragment": "3f9a0c21"
  }'
{
  "records": [
    {
      "objectType": "OBJECT_TYPE_CONTRACTS_PURCHASE",
      "id": "MDEyMzQ1Njc4OTo7PD0+Pw==",
      "marketHashName": "AK-47 | Redline (Field-Tested)"
    }
  ]
}