API Documentation

Classify products, calculate duties, check compliance — all with provenance-backed answers.

Base URL: https://api.askrosetta.aiAuth: Authorization: Bearer YOUR_API_KEY

Authentication

All requests require an API key passed in the Authorization header.

Authorization: Bearer ar_live_abc123...

Get your API key at askrosetta.ai/signup. Free tier: 25 classifications/day, no credit card required.

Endpoints

POST/api/v1/classify

Classify Product

Classify a product description to an HTS code with confidence score, duty rate, and provenance.

Parameters

productstringrequiredProduct description
originstringCountry of origin (ISO 2-letter)
destinationstringDestination country (default: US)

Example Request

curl -X POST https://api.askrosetta.ai/api/v1/classify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product": "cotton t-shirt", "origin": "CN"}'

Response

{
  "hts_code": "6109.10.0012",
  "description": "T-shirts, singlets ... of cotton, Men's or boys'",
  "duty_rate": "16.5%",
  "confidence": 94,
  "section_301": true,
  "provenance": {
    "cfr_cite": "19 CFR 10.195",
    "cbp_rulings": ["N123456"]
  }
}
POST/api/v1/duty

Calculate Duty

Calculate total landed cost including duty, MPF, HMF, and any Section 301/IEEPA surcharges.

Parameters

hts_codestringrequiredHTS code (6-10 digits)
valuenumberrequiredDeclared value (USD)
originstringrequiredCountry of origin (ISO 2-letter)
quantitynumberNumber of units

Example Request

curl -X POST https://api.askrosetta.ai/api/v1/duty \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hts_code": "6109.10.0012", "value": 500, "origin": "CN"}'

Response

{
  "duty_rate": "16.5%",
  "duty_amount": 82.50,
  "mpf": 2.52,
  "hmf": 1.25,
  "section_301_rate": "7.5%",
  "section_301_amount": 37.50,
  "total_duties": 123.77,
  "landed_cost": 623.77
}
POST/api/v1/compliance

PGA Screening

Screen a product against Partner Government Agencies: FDA, EPA, USDA, CPSC, FCC, and more.

Parameters

hts_codestringrequiredHTS code
productstringProduct description for enhanced screening

Example Request

curl -X POST https://api.askrosetta.ai/api/v1/compliance \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hts_code": "0409.00.0000", "product": "organic honey"}'

Response

{
  "agencies": [
    {
      "agency": "FDA",
      "flag_code": "FD1",
      "requirement": "Prior Notice required",
      "details": "Food facility registration + PN filing 15 days before arrival"
    }
  ],
  "risk_level": "medium",
  "action_required": true
}

Rate Limits

TierDaily LimitBurst Rate
Free25/day5/min
Grow250/day30/min
Starter750/day60/min
Pro3,500/day100/min
EnterpriseCustomCustom

Rate limit headers: X-RateLimit-Remaining, X-RateLimit-Reset. Exceeding limits returns 429 Too Many Requests.

Error Codes

CodeMeaning
200Success
400Bad request — missing or invalid parameters
401Unauthorized — missing or invalid API key
429Rate limit exceeded — wait and retry
500Server error — retry with exponential backoff

MCP Integration

AskRosetta is available as an MCP server for Claude Desktop, Cursor, and other AI tools. 64 trade intelligence tools accessible directly from your IDE.

// claude_desktop_config.json
{
  "mcpServers": {
    "askrosetta": {
      "url": "https://mcp.askrosetta.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Ready to start classifying?

Get Your API Key