Broker Genius API Documentation

Overview

The Broker Genius API provides U.S. HTS (Harmonized Tariff Schedule) code classification services for import/export items. The API leverages advanced AI to accurately determine the proper 10-digit HTS code for product descriptions and identify any applicable Partner Government Agency (PGA) requirements.

This API uses an asynchronous processing model - you submit a batch of items, receive a batch ID immediately, and then retrieve the results once processing is complete. For large batches, you can provide a webhook URL to receive a notification when processing is finished.

Authentication

All API requests must include an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Obtaining an API Key

1. Log in to your Broker Genius account
2. Navigate to "Account Profile" in the top-right user menu
3. Select the "API Keys" tab
4. Use this key in all API requests in the Authorization header

For security, API keys should be kept confidential and not shared publicly. You can generate multiple API keys for different applications or services, and revoke them individually if needed.

Endpoints

Our API offers multiple ways to classify your products using advanced AI. Choose the submission method that best suits your needs:

• Submit Text

  The text submission API allows you to classify products based on their textual descriptions. Simply send a batch of product descriptions, and our AI will analyze the text to determine the appropriate HTS codes, duty rates, and regulatory requirements.

  Example:

  "Women's knit cotton sweater with embroidered pattern, long sleeves, no hood, 100% cotton"

  Result: HTS 6110.20.2070 - Women's cotton sweaters, 16.5% duty rate

• Submit Images

  The image classification endpoint enables you to submit product images for HTS code identification. This is particularly useful for items that are difficult to describe in text or when you need confirmation based on visual characteristics.

  Example:

  {
    "item": [
      {
        "id": "prod123",
        "image_url": "https://example.com/products/leather-wallet.jpg"
      }
    ]
  }

  Result: HTS 4202.31.0000 - Leather wallet, 8% duty rate

• Submit Invoices

  The invoice processing API streamlines classification for entire commercial invoices. By submitting PDF invoices, you can automatically extract and classify multiple line items at once, while preserving critical information like quantities, pricing, and invoice structure.

  Example:

  {
    "item": [
      {
        "id": "inv456",
        "invoice_url": "https://example.com/invoices/office-supplies-invoice.pdf"
      }
    ]
  }

  Result: Multiple items classified - Printer Paper (HTS 4802.55.2000), Sticky Notes (HTS 4820.10.2020), Office Chair (HTS 9401.99.9081)