Skip to main content
Version: 1.2.0-1.3.0

User Account Connect (Secondary features)

The User Account Connect API supports secondary features. The secondary features use the connection and response model explained under User Account Connect.

Connection info

Development environmentAPI base URI
Productionhttps://api.dosi.world

Get digital item list with access token

Gets the list of digital items in the user's DOSI account using the access token.

GET {API base URI}/api/v2/member/items/balance

This endpoint gets the digital item list with the access token that the user got issued after logging into DOSI. Use Digital Item Connect's Get digital item list if you don't have an access token.

Path

None

Query

Name
TypeDescription
Required
chainNamestring

Chain to use. Don't change the value from "realnet".

sortOrderstring

Sorting order. Choose one of the following:

  • CONTRACT_ID_ASC_TOKEN_TYPE_ASC_TOKEN_INDEX_ASC
  • CONTRACT_ID_DESC_TOKEN_TYPE_DESC_TOKEN_INDEX_DESC
pageSizenumber

Number of digital items per page. Must be greater than 0 and less or equal to 100.

pageTokenstring

Token for the start of the page. If this value is given, it will fetch digital items on the next page from this token. Starts from the first page if not provided.

This value must be URI encoded.

How to use

  • Don't provide this value when calling this API for the first time to fetch from the first page.
  • To get the next pageSize digital items, enter pageTokens.next from the response received after the previous call.
  • To get the previous pageSize digital items, enter pageTokens.prev from the response received after the previous call.
contractIdstring

Contract ID to filter. Gets digital items with this contract ID only.

tokenTypestring

Type to filter. Gets digital items with this type only.

Body

None

Headers
  • Authorization: Bearer <access token>
  • Content-Type: application/json

Request examples

curl -v -X GET "https://api.dosi.world/api/v2/member/items/balance?chainName=realnet&sortOrder=CONTRACT_ID_ASC_TOKEN_TYPE_ASC_TOKEN_INDEX_ASC&pageSize=50" \
--header 'Authorization: Bearer <access token>' \
--header 'Content-Type: application/json'