gtt logo

REST API

version 2501

Usage Limits

Number of Concurrent Reports

It is not possible to generate more than two API reports simultaneously. If two reports are currently in progress and an additional report request is submitted, the GTT API returns an error response with an HTTP status code of 400 and a text message indicating that the request could not be processed:
{
  "error": {
    "code: 400,
    "message": "TOO MANY CONCURRENT REPORTS ARE RUNNING. PLEASE WAIT UNTIL OTHER SUBMITTED REPORT(S) ARE FINISHING!"
  }
}

Trade Data provided by UN Comtrade

The report is limited to 100,000 trade data records for the reporting country with the UN Comtrade data source, as per the legal requirement of the UN Comtrade. If this limit is exceeded, the GTT API returns an error response with HTTP status code 400 and a text message indicating the error:
{
  "error": {
    "code": 400,
    "message": "[ERROR] The maximum limit of data extraction for UN Comtrade requests is 100000 per request. Your request for UN Comtrade country Barbados(BB) reached the limit. We suggest to split this request into several smaller requests to extract the data needed."
  }
}

Too Big Reports

In certain exceptional circumstances, the generation of the report may be rendered inoperable if the requested trade data comprises an excessive number of records (in the hundreds of thousands). In such instances, the GTT API returns an error response with an HTTP status code of 400, accompanied by a textual message indicating the reason for the error:
{
  "error": {
    "code": 400,
    "message": "Report is too big."
  }
}