Get an importer profile

Get one importer’s monthly container history, ports of discharge, origin countries, carriers, destination states, and HS4 commodities from US import bill-of-lading records.

POST /trade_intel/companies/profile

cURL

One state, 12 months

curl --request POST \
  --url https://api.terminal49.com/v2/trade_intel/companies/profile \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_name": "CATERPILLAR",
  "company_state": "IL"
}
'

200

{
  "company_name": "EXAMPLE OUTDOOR SUPPLY",
  "company_state": null,
  "since": "2025-10",
  "until": "2026-09",
  "found": true,
  "totals": {
    "containers": 1240,
    "containers_as_consignee": 1180,
    "containers_as_notify_party": 60,
    "teus": 2310.5,
    "states": [
      "GA",
      "CA"
    ]
  },
  "monthly": [
    {
      "month": "2025-10",
      "containers": 95,
      "teus": 180
    },
    {
      "month": "2025-11",
      "containers": 110,
      "teus": 205.5
    }
  ],
  "ports_of_discharge": [
    {
      "name": "SAVANNAH",
      "containers": 900,
      "teus": 1700
    }
  ],
  "origin_countries": [
    {
      "name": "VIETNAM",
      "containers": 700,
      "teus": 1300
    }
  ],
  "carriers": [
    {
      "name": "MAERSK LINE",
      "containers": 500,
      "teus": 950
    }
  ],
  "destination_states": [
    {
      "name": "GA",
      "containers": 900,
      "teus": 1700
    }
  ],
  "commodities_hs4": [
    {
      "hs4": "9401",
      "description": "Seats (other than barber, dental, etc), and part",
      "containers": 800,
      "estimated_value": 31000000
    }
  ],
  "notes": [
    "volume is physical containers, each counted once even when it appears on several bills",
    "the period covers full calendar months ending last month"
  ]
}

Authorizations

Authorization · string · header · required

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

Authorization: Token YOUR_API_KEY

Body

application/json

company_name · string · required

Exact company_name from companies/search.

Required string length: 1 - 200

Example:

"CATERPILLAR"

company_state · string | null

Restrict to one state; omit for all states.

Maximum string length: 2

Example:

"IL"

months · integer · default: 12

Full calendar months ending last month. Use 24 or more for a year-over-year view.

Required range: 1 <= x <= 60

Response

200

application/json

OK

Import profile for one company. When found is true the totals, monthly series, breakdowns, and notes are returned.

company_name · string · required

The requested company name.

Example:

"CATERPILLAR"

company_state · string | null · required

The requested state, or null for all states.

since · string · required

First month of the period (inclusive).

Example:

"2025-10"

until · string · required

Last month of the period (inclusive).

Example:

"2026-09"

found · boolean · required

false when the exact name has no volume in the period. The name must match companies/search exactly; a company can also be split across several names.

totals · object

Show child attributes

monthly · object[]

Volume per month, oldest first.

Show child attributes

ports_of_discharge · object[]

US ports of discharge.

Show child attributes

origin_countries · object[]

Origin countries.

Show child attributes

carriers · object[]

Ocean carriers as spelled on manifests. Merge spelling variants before computing shares.

Show child attributes

destination_states · object[]

Destination US states.

Show child attributes

commodities_hs4 · object[]

HS4 headings with estimated value.

Show child attributes

notes · string[]

Counting caveats that apply to this response, for example that volume is physical containers or that the window includes a partial month. Surface these to end users.