xTrace: Open API Description for business user

Open API is intended for interaction between good's circulation participants (GCP) and the Digital Marking Information System and allows performing the following operations with marking codes (MC):

• obtaining a list of MC;

• obtaining public and detailed information about MC;

• verifying the counterparty’s registration;

• sending and reviewing a request for the transfer of MC;

• forming and disbanding AIK;

• aggregation and disaggregation of KITU;

• checking product descriptions (cards).

Starting from document version v.1.7.2, sending API requests for ICOM methods using a business user’s API key is allowed.
In this regard, the ability to work with the following operations has been added:

• working with MC orders;

• working with reports;

• viewing and submitting documents.

To interact with the Open API on behalf of a GCP, it is recommended to create an API key of the bearerToken type, which is used in the Authorization header.
The requirements and creation procedure are presented in the article “Creating an API key”.

Main differences compared to True API:

• the authorization scheme has changed;

• the request submission and response receipt scheme has changed;

• the directory of returned parameters has been updated.

In the method public/api/cod/private/codes, the set of returned data has been expanded — it now includes most of the values that were previously available only through additional parameters.

If the required rights are missing (that is, when the request sender is not the current owner of the desired code), the request to public/api/cod/private/codes is automatically redirected to the method public/api/cod/public/codes.

Authorization scheme as of 25.08.2025

Download the documentation ⬇️