Get a US company profile by slug

1 per record

Return the full ImportYeti profile for a US company using its URL slug (e.g. ikea-supply), not the legal name. Resolve names via company search first.

curl -X GET "https://data.importyeti.com/v1.0/company/ikea-supply" \
  -H "IYApiKey: YOUR_API_KEY" \
  -H "Accept: application/json"

Try it

Runs a real request and spends real credits. Your key stays in this browser.

API key

Base URL

https://data.importyeti.com

Path parameters

company*ImportYeti company URL slug — the hyphenated segment from the website path /company/... (e.g. ikea-supply), not the company display or legal name. To resolve a name to a slug, use GET /company/search. Slugs use lowercase letters, digits, and hyphens; letter casing in this parameter is normalized. Underscores are accepted in place of hyphens.

Query parameters

Request

GET https://data.importyeti.com/v1.0/company/ikea-supply

Add an API key above to send. Get a key →

Example responsesample

{
  "requestCost": 1,
  "creditsRemaining": 99999994,
  "executionTime": "17ms",
  "data": {
    "title": "Ikea Supply",
    "also_known_names": [
      "017 D Tikea Supply",
      "017 D Tikea Supply Ag",
      "017 Dt 1 Ikea Distribution Services",
      "017 Dt 1 Ikea Supply",
      "017 Dt 1 Ikea Supply Ag"
    ],
    "total_shipments": 1317223,
    "most_recent_shipment": null,
    "first_shipment": null,
    "contact_info": null,
    "hs_codes": [
      {
        "hs_code": "94",
        "shipments": 983972,
        "shipments_12m": 94678,
        "weight": 8666045044,
        "teu": 2094303,
        "description": "Furnitures",
        "children": [
          {
            "hs_code": "9403",
            "shipments": 902841,
            "shipments_12m": 77036,
            "weight": 8300632337,
            "teu": 1924202,
            "description": "Other furniture and parts thereof",
            "children": [
              {
                "hs_code": "9403.50",
                "shipments": 681211,
                "shipments_12m": 30662,
                "weight": 6554954396,
                "teu": 1456412,
                "description": "Wooden furniture of a kind used in the bedroom"
              },
              {
                "hs_code": "9403.60",
                "shipments": 132984,
                "shipments_12m": 29953,
                "weight": 1224190593,
                "teu": 280979,
                "description": "Other wooden furniture"
              },
              {
                "hs_code": "9403.20",
                "shipments": 67265,
                "shipments_12m": 9658,
                "weight": 340868944,
                "teu": 141821,
                "description": "Other metal furniture"
              },
              {
                "hs_code": "9403.91",
                "shipments": 6002,
                "shipments_12m": 3022,
                "weight": 48606777,
                "teu": 12694,
                "description": "Of wood"
              },
              {
                "hs_code": "9403.99",
                "shipments": 5171,
                "shipments_12m": 1679,
                "weight": 31503890,
                "teu": 10932,
                "description": "Other"
              },
              {
                "hs_code": "9403.70",
                "shipments": 1551,
                "shipments_12m": 620,
                "weight": 6697356,
                "teu": 3233,
                "description": "Furniture of plastics"
              },
              {
                "hs_code": "9403.82",
                "shipments": 2205,
                "shipments_12m": 582,
                "weight": 11940149,
                "teu": 4676,
                "description": "Of bamboo"
              },
              {
                "hs_code": "9403.40",
                "shipments": 1676,
                "shipments_12m": 448,
                "weight": 24872915,
                "teu": 3530,
                "description": "Wooden furniture of a kind used in the kitchen"
              },
              {
                "hs_code": "9403.30",
                "shipments": 4776,
                "shipments_12m": 412,
                "weight": 56997317,
                "teu": 9925,
                "description": "Wooden furniture of a kind used in offices"
              }
            ]
          },
          {
            "hs_code": "9401",
            "shipments": 60276,
            "shipments_12m": 11002,
            "weight": 278331074,
            "teu": 126478,
            "description": "Seats (other than those of heading 9402), whether or not convertible into beds, and parts thereof",
            "children": [
              {
                "hs_code": "9401.61",
                "shipments": 39944,
                "shipments_12m": 7572,
                "weight": 154612078,
                "teu": 83757,
                "description": "Upholstered"
              },
              {
                "hs_code": "9401.69",
                "shipments": 7938,
                "shipments_12m": 1170,
                "weight": 63749260,
                "teu": 16754,
                "description": "Other"
              },
              {
                "hs_code": "9401.99",
                "shipments": 1759,
                "shipments_12m": 630,
                "weight": 6628560,
                "teu": 3729,
                "description": "Other"
              },
              {
                "hs_code": "9401.41",
                "shipments": 1731,
                "shipments_12m": 593,
                "weight": 6545618,
                "teu": 3670,
                "description": "Of wood"
              },
              {
                "hs_code": "9401.79",
                "shipments": 6721,
                "shipments_12m": 585,
                "weight": 36301486,
                "teu": 14081,
                "description": "Other"
              },
              {
                "hs_code": "9401.39",
                "shipments": 2183,
                "shipments_12m": 452,
                "weight": 10494074,
                "teu": 4486,
                "description": "Other"
              }
            ]
          },
          {
            "hs_code": "9404",
            "shipments": 13764,
            "shipments_12m": 3567,
            "weight": 65964971,
            "teu": 28622,
            "description": "Mattress supports; articles of bedding and similar furnishing (for example, mattresses, quilts, eiderdowns, cushions, pouffes and pillows) fitted with springs or stuffed or internally fitted with any material or of cellular rubber or plastics, whether or not covered",
            "children": [
              {
                "hs_code": "9404.90",
                "shipments": 11490,
                "shipments_12m": 2736,
                "weight": 56665775,
                "teu": 23799,
                "description": "Other"
              },
              {
                "hs_code": "9404.40",
                "shipments": 2274,
                "shipments_12m": 831,
                "weight": 9299196,
                "teu": 4824,
                "description": "Quilts, bedspreads, eiderdowns and duvets (comforters)"
              }
            ]
          },
          {
            "hs_code": "9405",
            "shipments": 7091,
            "shipments_12m": 3073,
            "weight": 21116662,
            "teu": 15001,
            "description": "Luminaires and lighting fittings including searchlights and spotlights and parts thereof, not elsewhere specified or included; illuminated signs, illuminated nameplates and the like, having a permanently fixed light source, and parts thereof not elsewhere specified or included",
            "children": [
              {
                "hs_code": "9405.29",
                "shipments": 4228,
                "shipments_12m": 2057,
                "weight": 12270054,
                "teu": 8966,
                "description": "Other"
              },
              {
                "hs_code": "9405.21",
                "shipments": 1243,
                "shipments_12m": 615,
                "weight": 3288668,
                "teu": 2636,
                "description": "Designed for use solely with light-emitting diode (LED) light sources"
              },
              {
                "hs_code": "9405.19",
                "shipments": 1620,
                "shipments_12m": 401,
                "weight": 5557940,
                "teu": 3399,
                "description": "Other"
              }
            ]
          }
        ]
      },
      {
        "hs_code": "39",
        "shipments": 42140,
        "shipments_12m": 6989,
        "weight": 238724206,
        "teu": 88812,
        "description": "Plastics",
        "children": [
          {
            "hs_code": "3926",
            "shipments": 13128,
            "shipments_12m": 2957,
            "weight": 67373835,
            "teu": 27631,
            "description": "Other articles of plastics and articles of other materials of headings 3901 to 3914",
            "children": [
              {
                "hs_code": "3926.90",
                "shipments": 13128,
                "shipments_12m": 2957,
                "weight": 67373835,
                "teu": 27631,
                "description": "Other"
              }
            ]
          },
          {
            "hs_code": "3924",
            "shipments": 29012,
            "shipments_12m": 4032,
            "weight": 171350371,
            "teu": 61180,
            "description": "Tableware, kitchenware, other household articles and hygienic or toilet articles, of plastics",
            "children": [
              {
                "hs_code": "3924.10",
                "shipments": 20707,
                "shipments_12m": 2828,
                "weight": 129968242,
                "teu": 43723,
                "description": "Tableware and kitchenware"
              },
              {
                "hs_code": "3924.90",
                "shipments": 8305,
                "shipments_12m": 1204,
                "weight": 41382129,
                "teu": 17457,
                "description": "Other"
              }
            ]
          }
        ]
      },
      {
        "hs_code": "73",
        "shipments": 18787,
        "shipments_12m": 4152,
        "weight": 99038290,
        "teu": 39627,
        "description": "Iron/Steel products",
        "children": [
          {
            "hs_code": "7323",
            "shipments": 12750,
            "shipments_12m": 2631,
            "weight": 55114654,
            "teu": 26920,
            "description": "Table, kitchen or other household articles and parts thereof, of iron or steel; iron or steel wool; pot scourers and scouring or polishing pads, gloves and the like, of iron or steel",
            "children": [
              {
                "hs_code": "7323.93",
                "shipments": 9601,
                "shipments_12m": 2057,
                "weight": 38193361,
                "teu": 20311,
                "description": "Of stainless steel"
              },
              {
                "hs_code": "7323.99",
                "shipments": 3149,
                "shipments_12m": 574,
                "weight": 16921293,
                "teu": 6608,
                "description": "Other"
              }
            ]
          },
          {
            "hs_code": "7326",
            "shipments": 6037,
            "shipments_12m": 1521,
            "weight": 43923636,
            "teu": 12708,
            "description": "Other articles of iron or steel",
            "children": [
              {
                "hs_code": "7326.90",
                "shipments": 6037,
                "shipments_12m": 1521,
                "weight": 43923636,
                "teu": 12708,
                "description": "Other"
              }
            ]
          }
        ]
      }
    ],
    "top_trading_partners": null,
    "address": "Lebec, Ca 93243, Us",
    "website": "inter.ikea.com"
  }
}

Parameters#

Path parameters

companystringrequired
ImportYeti company URL slug — the hyphenated segment from the website path /company/... (e.g. ikea-supply), not the company display or legal name. To resolve a name to a slug, use GET /company/search. Slugs use lowercase letters, digits, and hyphens; letter casing in this parameter is normalized. Underscores are accepted in place of hyphens.

Query parameters

fieldsstringoptional
Comma-separated list of fields to keep on each returned record, e.g. bol_number,arrival_date,supplier_name. Everything else is omitted. Names that the record does not carry are ignored. The envelope (requestCost, creditsRemaining, executionTime, totalCount) is always returned in full. Cannot be combined with exclude. Omit for the full record.
excludestringoptional
Comma-separated list of fields to drop from each returned record, e.g. containers,shipping_rate. Every other field is kept. Cannot be combined with fields. Omit for the full record.
formatstringoptionaldefault json
Response encoding. Defaults to json. Pass toon to receive TOON — the same data in a compact, token-efficient text form intended for LLM prompts. Error responses are always JSON.
one ofjsontoon

fields, exclude, and format work the same way on every endpoint — Response shaping has worked examples.

Response#

The full US company profile — names, shipment volume, contacts, HS codes, and trading partners.

Response shape

{
  "requestCost": 1,
  "creditsRemaining": 9998.5,
  "data": {
    "title": "Walmart",
    "also_known_names": ["Walmart Inc", "Walmart Usa"],
    "address": "601 N Walton Blvd, Bentonville, Ar 72712, Us",
    "address_plain": "601 N Walton Blvd Bentonville Ar 72716-0410 Usa",
    "website": "walmart.com",
    "other_websites": [{"website": "ups.com", "frequency": 6}],
    "phone_number": "+18009256278",
    "total_shipments": 436207
    // …22 more fields
  },
  "executionTime": "224ms"
}

Top-level fields#

data — the result object for this endpoint
requestCost — Data credits used for this call (0 if none)
creditsRemaining — Your data credit balance after the call
executionTime — How long the request took

Fields in data#

FieldExample

30 fields

titlestringWalmart
also_known_namesstring[]["Walmart Inc", "Walmart Usa"]
addressstring601 N Walton Blvd, Bentonville, Ar 72712, Us
address_plainstring601 N Walton Blvd Bentonville Ar 72716-0410 Usa
address, most_recent_shipment_to, contact_info_data
websitestringwalmart.com
[{"website": "ups.com", "frequency": 6}]
website, frequency
phone_numberstring+18009256278
total_shipmentsnumber436207
The company's total shipments on record, independent of the filters in this query.
countrystringUnited States
country_codestringUS
carriers_per_countryobject

Errors#

Failures come back as JSON with a statusCode and message. The ones worth handling here are 401 (bad or missing key), 403 (out of credits), and 404 (no such record). See all error responses.