Skip to content

API Reference / Audit

List audit log entries

Lists audit log entries for the caller's workspace, optionally filtered by object type, action type, or exact event type. There is no workspace_id request field. The scope is always the caller's own workspace, except for a platform administrator, who reads across every workspace plus the entries tied to no workspace. Results are paginated. Pass the returned cursor to fetch the next page.

POST/audit.v1.Audit/ListAuditEntries

Request body

application/jsonRequired

Request for one page of audit entries in the caller's workspace, newest first. There is no workspace field: the workspace is always the caller's own.

cursor?string

Opaque cursor from a previous ListAuditEntriesResponse.next_cursor. Empty for the first page. Send the same filter with every page.

filter?AuditEntryFilter

Optional narrowing by object type, action type or event type. Absent returns every entry.

Show attributes
actionTypes?array<string>

Action types to include, matching any of them. Empty includes every action type.

Value in"ACTION_TYPE_CREATED""ACTION_TYPE_UPDATED""ACTION_TYPE_DELETED"

entityId?string

Only entries about this entity, matching entity_id exactly.

eventType?string

Exact event type to match, such as "user.created" or "security". Absent or empty applies no event type filter.

objectTypes?array<string>

Object types to include, matching any of them. Empty includes every object type.

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"

occurredBefore?string

Keeps only entries that occurred strictly before this time. Absent applies no upper bound.

Format"date-time"

occurredFrom?string

Keeps only entries that occurred at or after this time. Absent applies no lower bound.

Format"date-time"

performedByApiKeyId?string

Opaque 16-byte identifier of an API key, base64-encoded in JSON. Keeps only the entries performed through that key. Absent applies no key filter. Set this or performed_by_user_id, not both.

Format"byte" base64

performedByUserId?string

Opaque 16-byte identifier of a user, base64-encoded in JSON. Keeps only the entries that user performed, through their own sessions or through API keys they own. Absent applies no person filter.

Format"byte" base64

query?string

Free text to search for, matched case-insensitively against the summary and the entity's name, and against the names of the workspace's members and API keys as the performer. Absent or blank applies no search.

limit?integer

Maximum number of entries to return, from 1 to 100. Zero uses the default of 50. A larger value is rejected with invalid_argument.

Format"int32"

Response body

application/json

Success

auditEntries?array<AuditEntry>

The audit entries on this page, ordered by occurred_at descending.

Show attributes
actionType?string

What happened to the entity, in lowercase, such as "created", "updated", "deleted" or "restored".

category?string

The customer grouping the entry belongs to. Unspecified on entries recorded before this field existed.

Value in"AUDIT_CATEGORY_PEOPLE""AUDIT_CATEGORY_TRADING""AUDIT_CATEGORY_STEAM""AUDIT_CATEGORY_PROXIES""AUDIT_CATEGORY_BILLING""AUDIT_CATEGORY_SECURITY""AUDIT_CATEGORY_SETTINGS"

changes?array<AuditChange>

What the action changed, one row per audited field, ready to display. Empty when nothing audited changed, and on entries recorded before this field existed. Secrets are never included.

Show attributes
after?string

The value after the change, formatted for display. Empty when it was cleared.

before?string

The value before the change, formatted for display. Empty when it had none.

field?string

The field's customer-facing label, such as "Name".

createdAt?string

When the entry was written to the audit log. Usually moments after occurred_at.

Format"date-time"

details?string

Action-specific detail as a UTF-8 JSON object, base64-encoded in JSON. Empty when the action carries no detail. Never contains secrets or credential material.

Format"byte" base64

entityId?string

Identifier of the entity acted on, as text. Empty when the action has no single target entity.

eventId?string

Identifier of the platform event this entry was recorded from. Unique across the audit log, so a redelivered event never produces a second entry.

eventType?string

Event name, either the dotted platform event name such as "user.created" or the category "security" for login, two-factor and credential actions.

id?string

Opaque 16-byte identifier of this audit entry, assigned when the entry is recorded. Base64-encoded in JSON.

Format"byte" base64

objectName?string

The display name of the entity at the time of the action, such as the contract's name. Empty when the entity has no name, and on entries recorded before this field existed.

objectType?string

The kind of entity acted on, in lowercase, such as "workspace", "contract" or "api_key".

occurredAt?string

When the action happened, as stamped by the service that performed it.

Format"date-time"

performedBy?ActorSummary

Who performed the action, resolved when the entry is read. Unset for an entry with no person or key behind it.

Show attributes
avatarUrl?string

The user's avatar image URL. Unset for an API key or a user with no avatar.

displayName?string

The user's name or the API key's name at read time. Empty when the actor no longer exists.

id?string

Opaque 16-byte identifier of the user or API key, base64-encoded in JSON.

Format"byte" base64

subjectType?string

How the actor authenticated: a user session or an API key.

Value in"SUBJECT_TYPE_SESSION""SUBJECT_TYPE_API_KEY""SUBJECT_TYPE_SERVICE"

service?string

The platform service that performed the action, such as "accounts" or "contracts". Empty when the source service was not recorded.

summary?string

One-line human-readable description of the action, in the form "<object> <action>: <name>", such as "contract created: AK-47 buyer". The name part is omitted when the entity has none.

workspaceId?string

Opaque 16-byte identifier of the workspace the action belongs to, base64-encoded in JSON. Empty for a security entry that belongs to no workspace, such as a failed login for an unknown email, which only a platform administrator can read.

Format"byte" base64

nextCursor?string

Cursor to pass as cursor to fetch the next page. Empty when this is the last page.

curl -X POST "https://api.goldmine.to/audit.v1.Audit/ListAuditEntries" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "auditEntries": [
    {
      "id": "MDEyMzQ1Njc4OTo7PD0+Pw==",
      "workspaceId": "AAECAwQFBgcICQoLDA0ODw==",
      "eventId": "b1c2d3e4-f5a6-4788-8899-aabbccddeeff",
      "eventType": "membership.updated",
      "objectType": "accounts_membership",
      "actionType": "updated",
      "service": "accounts",
      "entityId": "20212223-2425-2627-2829-2a2b2c2d2e2f",
      "performedBy": {
        "subjectType": "SUBJECT_TYPE_SESSION",
        "id": "MDEyMzQ1Njc4OTo7PD0+Pw==",
        "displayName": "Jordan Hale"
      },
      "summary": "Updated membership role",
      "details": "eyJiZWZvcmUiOnsicm9sZSI6Ik1FTUJFUlNISVBfUk9MRV9NRU1CRVIifSwiYWZ0ZXIiOnsicm9sZSI6Ik1FTUJFUlNISVBfUk9MRV9PV05FUiJ9fQ==",
      "occurredAt": "2026-06-29T12:15:00Z",
      "createdAt": "2026-06-29T12:15:00Z"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjUwfQ=="
}