2. Accounts management

Working with counterparties you have the following features:

Get account

Create account

Get accounts list

Get account

Get the accounts that are visible for the user.

Get account

get

Get dcm account

Path parameters

counterparty_guidstringRequired

Counterparty GUID

account_guidstringRequired

wallet account guid (uuid)

Header parameters

X-Auth-TokenstringRequired

auth user token

Responses

200

OK

application/json

400

json with error msg

application/json

get

/counterparty/{counterparty_guid}/accounts/{account_guid}

HTTPcURLJavaScriptPython

GET /api/v1/counterparty/{counterparty_guid}/accounts/{account_guid} HTTP/1.1
Host: dev-dcm-api.armenotech.dev
X-Auth-Token: text
Accept: */*

{
  "activated": true,
  "assets": [
    {
      "activated": true,
      "balance": 1,
      "code": "text",
      "minor_unit": 1,
      "name": "text",
      "platform": "text"
    }
  ],
  "assets_total": 1,
  "blocked": true,
  "guid": "text",
  "name": "text",
  "platform": "text",
  "registered": true,
  "type": "text"
}

Create account

Accounts can be created in 4 ways:

1. a counterparty is created together with 2 accounts: emission account and processing account.

2. an internal user can create an additional processing account for their counterparty (e.g., to separate asset flow between branches)

3. an internal user can create an account for a linked external user (each external user has their own Stellar account)

4. an external user can create an account for themselves

Create account

post

Create dcm account

Path parameters

counterparty_guidstringRequired

Counterparty GUID

Header parameters

X-Auth-TokenstringRequired

auth user token

Body

application/json

account_kindstring · enumOptionalPossible values:

Responses

200

OK

application/json

400

json with error msg

application/json

post

/counterparty/{counterparty_guid}/accounts

HTTPcURLJavaScriptPython

POST /api/v1/counterparty/{counterparty_guid}/accounts HTTP/1.1
Host: dev-dcm-api.armenotech.dev
X-Auth-Token: text
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "account_kind": "issuer"
}

{
  "wallet_guid": "text"
}

Get accounts list

Get the list of accounts that are visible for the user.

Get accounts list

get

Get dcm accounts list

Path parameters

counterparty_guidstringRequired

Counterparty GUID

Query parameters

wallet_account_guidsstring[]Optional

wallet account guid (uuid)

wallet_user_guidsstring[]Optional

wallet user guid (uuid)

limitintegerOptional

limit (int)

offsetintegerOptional

offset (int)

orderstring · enumOptional

list order (string)

Possible values:

Responses

200

OK

application/json

400

json with error msg

application/json

get

/counterparty/{counterparty_guid}/accounts

HTTPcURLJavaScriptPython

GET /api/v1/counterparty/{counterparty_guid}/accounts HTTP/1.1
Host: dev-dcm-api.armenotech.dev
Accept: */*

[
  {
    "created_at": "text",
    "updated_at": "text",
    "wallet_account_guid": "text",
    "wallet_user_guid": "text"
  }
]