Get trade intelligence coverage

Return the window, history start, partial month, and build time of Terminal49 trade intelligence, built from US import bill-of-lading records.

GET /trade_intel/meta

Get trade intelligence coverage

cURL

curl --request GET \
  --url https://api.terminal49.com/v2/trade_intel/meta \
  --header 'Authorization: <api-key>'

200

{
  "since_month": "2025-09",
  "until_month_exclusive": "2026-09",
  "months": 12,
  "min_containers": 5,
  "companies": 250000,
  "hs_codes": 1200,
  "facts_since_month": "2022-01",
  "facts_until_exclusive": "2026-11",
  "partial_month": "2026-10",
  "mode": "local",
  "facts_hash": "3f9c1a7e",
  "refreshed_since": "2026-10-01",
  "fact_rows": {
    "lane_month": 1200000,
    "company_month": 9800000,
    "commodity_month": 6400000,
    "hs_lane_month": 15000000
  },
  "volume_measure": "containers",
  "built_at": "2026-10-08T06:12:44Z"
}

Authorizations

Authorization · string · header · required

Use a Terminal49 API key in the Authorization header with the Token prefix.

Authorization: Token YOUR_API_KEY

Response

200

application/json

OK

Index window, freshness, and counts. Also returned as index by companies/search.

since_month · string · required

First month of the 12-full-month window that search results and rankings cover.

Example:

"2025-09"

until_month_exclusive · string · required

Month after the last full month in the search window (exclusive).

Example:

"2026-09"

months · integer · required

Number of full months in the search window.

Example:

12

min_containers · integer · required

Minimum containers in the window for a company to be in the search index.

Example:

5

companies · integer · required

Companies in the search index.

Example:

250000

hs_codes · integer · required

HS4 codes in the search index.

Example:

1200

facts_since_month · string · required

First month of history available to companies/profile, importers/top, trends, and breakdown. History starts in January 2022.

Example:

"2022-01"

facts_until_exclusive · string · required

Month after the latest month with data (exclusive).

Example:

"2026-11"

partial_month · string · required

The current calendar month, which is still being loaded and is incomplete.

Example:

"2026-10"

mode · string · required

Serving mode of the index.

Example:

"local"

facts_hash · string · required

Fingerprint of the current fact build. It changes whenever the data is refreshed.

refreshed_since · string · required

Start of the period covered by the most recent daily refresh.

Example:

"2026-10-01"

fact_rows · object · required

Row counts of the monthly fact tables behind the analytics endpoints.

Show child attributes

volume_measure · string · required

Unit of every containers figure: physical containers, each counted once.

Example:

"containers"

built_at · string<date-time> · required

When the index was built.

Example:

"2026-10-08T06:12:44Z"