CargoX | API, the magic glue of business innovation
Why The CargoX Platform
Platform Help Login Register
Exporting to Egypt? Prepare for Egyptian ACI NOW. Start here

API, the magic glue of business innovation

Nov. 24, 2021, 11 a.m.

Simon Ručigaj
digitalization advisor and communication manager


The digitalization of global trade is picking up speed at an unprecedented pace. New solutions, platforms, and digital marketplaces are springing up everywhere. Manufacturers, exporters, importers, trading companies, and all other entities involved in the process need to learn how to use all the new tools, applications, and processes that differ from what they are used to, and find new ways to utilize the data stored in them. 

As new technologies emerge, there is a clear trend of seeing lots of new platforms fighting for market share to become the tools in global trade, to provide better opportunities for companies and organizations. Each of these platforms might have its own user interface, approach to getting things done, a different method of use – something that users, administrative workers, marketers, and managers need to learn to use efficiently.

Large corporations and organizations have long been using software solutions, tailored to their needs. They are used to tightly integrating them together, and being able to share their data and features between the applications and databases. This allows them to optimize their work processes, reduce time needed to perform tasks, improve data quality, and ensure internal and external compliance. Besides, they can streamline the workload for their workforce and find new opportunities – and grow their business potential. 

UI, API, or both?

So, what is the fastest way for companies to introduce a new, complex application or platform into the market? They can generally opt for one of two options. 

A user interface for use by a human

The easiest way to innovate in a corporate business process is to start using the application manually through its own user interface (UI) – a system of screens, pages, forms, and other graphic elements. A user interface basically enables interaction between a user and an application. 

Basic training is needed, but with the CargoX Platform this is a short and simple task. Users need to learn how to use the new application from scratch, and that the proper way to use it might be slightly different from what they are familiar with. User guidance is usually provided in the form of a User Manual, or through specific application training.

Application programming interface (API) for data exchange between systems

The other way to introduce a new application into a business system is to integrate it into the existing workflows and software. This includes making it possible for the application to automatically connect with other existing solutions that the company already uses. 

This functionality is facilitated by the API – an Application Programming Interface. It functions as a connector in a software solution that provides simple communication between the new application and an existing system. The new application can be hosted in the same business environment, or in another business information system altogether, and by connecting with each other these applications create synergies. 

How does an API work

An API is generally used by an application, which calls specific functions in the API through a network connection and then receives returned data. 

An API is usually structured and divided into several sections. These sections can be used as separate tools or services that can be programmed to interact with another application. When a programmer or an application creates a connection with a particular section, it is referred to as performing a call to that section of the API. These calls are also known as subroutines, methods, requests, or endpoints. 

Sometimes, the API is public and anybody can use them and call specific functions. But more often, they are secured to only provide data service to authorized users or applications – and they need to be set up during a process called API integration. This process can include planning specific workflows in the company, planning how business information is captured, stored, retrieved, controlled, and managed, and planning capacities for different parts of software solutions that form the corporate IT environment. 

The description of available data calls, what the format of returned data is, and specific parameters are usually documented in an API Reference document. This is also a useful way to provide the software features to the user, while at the same time hiding internal details of how a system works.

In the era of internet applications and platforms, an API is usually accessible through web protocols, but other API integration methods for specific software architectures are also possible.

API documentation

Integrating the application’s features into an existing and operational environment through an API is performed by skilled IT engineers. 

For that purpose, API reference documentation is used, which is provided by the application provider. The API reference documentation usually contains quick set-up documents, typical usage scenarios, code snippets, performance discussions, contracts, references on how to structure calls for the basic tasks, and a complete reference document with all the calls, classes, methods, data formats, and parameters. 

CargoX Platform API developer’s reference 

The CargoX Platform for Blockchain Document Transfer (BDT) fully supports API integration with third-party applications. In fact, 100% of all platform’s functions are provided through API calls, and everything is well documented. 

Any company with skilled engineers can start their own CargoX Platform integration immediately – and it can also be completed fairly quickly, at minimum cost, and without any overtly complex procedures. 

The complete CargoX Platform developer documentation is accessible at 

Here you will find:

  • Integration scenarios

  • Authorization and authentication details

  • API v3 (latest) reference

  • How to add files from external sources to the CargoX Platform

  • How to seamlessly log in users

  • Webhooks

  • How to automatically create third-party client applications

  • Examples

  • Definitions of terms

Youredi, the key integration partner

For SMEs that wish to integrate CargoX Platform functionality into their business IT systems, but lack in-house integration engineers, there is an alternative.

Youredi has been developing integration services for major global markets for the past decade. From building an integration expert team to managing customer projects to building a cloud-based iPaaS to automate integrations, Youredi has covered it all – and in June 2021 they partnered with CargoX. 

They are a leading provider of fully managed data integration services and solutions for logistics and the global supply chain. Through the partnership calls, Youredi strives to provide smooth data integration for all those joining the platform. 

More information about CargoX Platform integration through Youredi can be found at Youredi Rapids eBOL connectivity.

CargoX Platform API documentation Request a demo

Other blog

WCO news: Egypt adopts innovative trade document exchange system
7 Dec 2022
An overview of the Egyptian adoption of innovative trade document exchange system, written by Gamal Kotb, General Manager at MTS and Igor Jakomin, Deputy CEO at CargoX, published originally in WCO News 99- Issue 3 / 2022 > Dossier: Disruptive Technologies, by World Customs Organization.
EU customs single window system promises one-stop-shop for customs formalities
17 Nov 2022
The Council of the European Union has made a leap forward by adopting new rules for a single window solution for customs processing and digital collaboration between customs and related authorities.
MLETR opening the door for electronic trade documents
5 Oct 2022
Last year saw tremendous growth in commitments to digitise international trade document flows and to accept electronic bills of lading and other electronic trade documents as standard and legally valid documents. Let's take a look at the progress in MLETR adoption and related activities.
DCSA eDocumentation standardization initiative overview and achievements
15 Sep 2022
DCSA’s major effort in the past three years has been overall standardisation of end-to-end document processes, with detailed data models and provision of interconnectivity for various platforms, which can self-certify compliance to various standards.
Document Management System vs. Document Transfer System
20 Jul 2022
When talking about electronic trade documents, it is important to outline where the document transfer systems touch and overlap with electronic document management systems, and what the main differences and advantages are.
How delegating makes filing Egypt ACI easier for principals through representative companies
23 May 2022
The CargoX Platform introduces delegations functionality to help principals delegate ACI filing to representative companies.
Blockchain document transfer: understanding the technology and its uses
26 Apr 2022
An overview article published in the World Customs Organization's News Magazine, written by Vjeran Ortynski, CBDO, CargoX, and Janez Kranjc, PhD, Chief Blockchain Officer, CargoX
In conversation: Vjeran Ortynski and Gamal Kotb, GM, MTS, about the CargoX and NAFEZA integration benefits
5 Apr 2022
The Egyptian Government has recently extended the ground-breaking customs project with CargoX (see the details here). Vjeran Ortynski, CBDO, CargoX, used this opportunity to talk to Mr. Gamal Kotb, GM, Misr Technology Services (MTS), to explain the benefits of this collaboration for the exporters, importers, and Egyptian governmental agencies.
International groups and frameworks for fast-tracking global trade document digitization
22 Mar 2022
CargoX has built a disruptive electronic trade document exchange platform with a neutral, public Ethereum blockchain. But despite the truly (r)evolutionary dimension, It is our goal for the CargoX Platform to be compliant with new and emerging industry standards. Some efforts among these are truly monumental and have started to gain traction and show real benefits for companies and organizations taking part in global trade.
What are the P&I clubs and what role do they play in the adoption of electronic Bill of Lading #eBL
26 Jan 2022
One of the most important moments in the business development of CargoX and its CargoX Platform for Blockchain Document Transfer (BDT) was the approval by the International Group of Protection & Indemnity Clubs back in February 2020. So, what does the IGP&I actually do?

Your free demo session with our experts

Please fill out the form below, and we will get back to you as soon as possible.

Trying to download the logo?

We have a better idea! Find high quality visuals in our press kit section.

Visit press kit