Skip to main content
GET
Get trade intelligence coverage

Authorizations

Authorization
string
header
required

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

Authorization: Token YOUR_API_KEY

Response

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.

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"