Skip to navigation

List an account's keys

Lists the keys beneath the account — the venue keys it was connected with or given since: key references and metadata, never the key material, each with its health — whether a connector is serving it. view=approved shows what is enforced; the default includes pending proposals. Ordered by credentialId, ascending. Needs venue-keys:read or any venue-keys capability.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idintegerRequired

The record’s id — a positive 32-bit integer the platform minted.

Headers

X-Request-IdstringOptional

Your own id for the request: 8 to 128 of [A-Za-z0-9._-]. It becomes the request’s id and is echoed on the response. A value off that grammar is replaced with a fresh id, never refused.

Query parameters

viewenumOptionalDefaults to latest

latest (the default) shows a row’s pending proposal where one exists; approved shows what the platform enforces. Resources without proposals serve the same rows for both.

Allowed values:
credentialIdintegerOptional>=1

Only rows whose credentialId is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not a positive 32-bit integer) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

accountIdintegerOptional>=1

Only rows whose accountId is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not a positive 32-bit integer) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

statusenumOptional

Only rows whose status is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not one of the values listed) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

Allowed values:
providerKindenumOptional

Only rows whose providerKind is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not one of the values listed) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

Allowed values:
exchangeIdintegerOptional>=1

Only rows whose exchangeId is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not a positive 32-bit integer) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

canReadBalancesbooleanOptional

Only rows whose canReadBalances is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not true or false) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

canExecuteTransfersbooleanOptional

Only rows whose canExecuteTransfers is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not true or false) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

canServeAddressesbooleanOptional

Only rows whose canServeAddresses is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not true or false) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

canTradebooleanOptional

Only rows whose canTrade is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not true or false) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

observedAllowlistenumOptional

Only rows whose observedAllowlist is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not one of the values listed) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

Allowed values:
probeOutcomeenumOptional

Only rows whose probeOutcome is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not one of the values listed) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

scopeUnobservedbooleanOptional

Only rows whose scopeUnobserved is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not true or false) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

pendingTransitionenumOptional

Only rows whose pendingTransition is one of these; repeat the parameter or comma-separate, at most 100 values. A value the row cannot carry (not one of the values listed) refuses 400 MALFORMED_REQUEST; a value naming no row yields an empty collection.

sortstringOptionalDefaults to credentialId

Comma-separated credentialId, accountId, status, providerKind, exchangeId, canReadBalances, canExecuteTransfers, canServeAddresses, canTrade, keyCreatedAtNs, rotateByNs, observedAllowlist, probeOutcome, probedAtNs, observedKeyCreatedAtNs, scopeUnobserved, name, pendingTransition, proposedAtNs or concludedAtNs; prefix - for descending. Default credentialId.

limitintegerOptional>=1

Page size, 1-100; larger values are clamped. Without it the whole collection is served as one page.

cursorstringOptional<=2048 characters

nextCursor or prevCursor from a previous page, sent with the same filters and the same sort. One that does not decode, or that came from another query, is refused 400 INVALID_CURSOR: drop it and fetch the first page.

includeenumOptional

total adds the exact number of rows matching the filters — the set served. deleted (0.39.0) serves the deleted rows among the live ones: without it, and without a status filter, the list leaves out the rows its terminal state has reached; a by-id read serves them as ever. deleted binds into the cursor as a filter does; total never did.

Allowed values:
minGlobalSequencestringOptionalformat: "^[0-9]{1,19}$"

A position you hold — an X-Immix-Global-Sequence you read, or a 202’s commandGlobalSequence: this member answers only once it has folded the platform’s stream through it, waiting up to its deadline, then 503 PROJECTION_BEHIND with Retry-After. Within that stream a read is never older than what you have seen; drop your positions after an announced stream cut. A retry stating its 202’s position attaches to or replays that operation while the journal holds its key, never publishing twice. Stated once: one to nineteen digits, at most 9223372036854775807; else 400 MALFORMED_REQUEST.

Response

A page of the rows inside the principal’s org, in the operation’s order, or the one sort asks — all of them unless limit is sent; the position it was read at rides the body and the headers.

asOfSeqTsNsstring or nullformat: "^[0-9]+$"

The sequencer timestamp (epoch-ns) the data is complete through; also sent as X-Immix-As-Of-Seq-Ts. Null when unknown.

globalSequencestringformat: "^[0-9]+$"

The position as a decimal string — the last change this member had applied, orders, balance readings and algo instances included.

itemslist of objects
nextCursorstring or null

Pass as cursor for the next page. Null on the last page.

prevCursorstring or null

Pass as cursor for the previous page. Null on the first page.

totalinteger or null

Exact count matching the filter. Null unless include=total.

Errors

400
List Account Keys Venue Keys Request Bad Request Error
401
List Account Keys Venue Keys Request Unauthorized Error
403
List Account Keys Venue Keys Request Forbidden Error
503
List Account Keys Venue Keys Request Service Unavailable Error