HomeGuidesAPI Reference
API Reference

Sync an investor's network accounts on an asset from the ledger adapter

post
https://example.com/profiles/investor//account/sync

Asks the asset's ledger adapter which network accounts it already holds for this
investor on the asset (e.g. wallets whitelisted directly on the adapter or its
external system) and makes that list the investor's onboarded accounts for
(organizationId, assetId): every returned wallet is recorded, and any wallet the
router previously held for that pair that the adapter did not return is removed.
An empty result clears the pair. No wallet is created and no challenge is issued.
Async: returns 202 { cid }; on completion the operation result carries the
recorded wallets in accounts. A ledger adapter without lookup support fails the
operation with 7352 (ACCOUNT_LOOKUP_NOT_SUPPORTED).

Path Params
string
required
length ≤ 150
^[^:](?:.+):101:(?:.+)

ID of the investor profile

Body Params

Request body for POST /profiles/investor/{investorId}/account/sync. Identifies the
(managing org, asset) whose ledger adapter is asked for the investor's accounts.

string
required
length between 1 and 150
^[^:]*$

Organization Id

string
required

ID of the asset

Headers
string
required

32 bytes buffer (24 randomly generated bytes by the client + 8 bytes epoch timestamp seconds) encoded to hex:

const nonce = Buffer.alloc(32);
nonce.fill(crypto.randomBytes(24), 0, 24);

const nowEpochSeconds = Math.floor(new Date().getTime() / 1000);
const t = BigInt(nowEpochSeconds);
nonce.writeBigInt64BE(t, 24);

Responses

Updated 2 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 days ago