StarShipperNew Frontiers in Shipping Tech
v2.1.0
OAS 3.0.3

StarShipper API

StarShipper API Support
Proprietary

Australian customs and tariff data API. Access duty rates from the ABF Working Tariff Schedule, preferential rates from 17 Free Trade Agreements, AI-powered HS code classification, and RBA exchange rates.

Primary Use Cases

  • Australian Importers: Look up duty rates, FTA preferential rates, and landed cost inputs
  • Freight Forwarders: Auto-classify goods to HS codes, check FTA eligibility
  • E-Commerce Platforms: Estimate import duties at checkout for Australian shipments
  • ERP Systems: Integrate tariff data into procurement and supply chain workflows

Authentication

Authentication is optional but recommended. Anonymous requests are rate-limited to 20 requests/hour.

To authenticate, include an API key in the X-API-Key header:

X-API-Key: sk_live_your_key_here

Get an API key by signing up at starshipper.io.

Rate Limits

Tier Requests/Hour
Anonymous (no key) 20
Free 100
Pro 1,000
Enterprise Custom

Rate limit headers are included in every response:

  • X-RateLimit-Limit: Total requests allowed per window
  • X-RateLimit-Remaining: Requests remaining
  • X-RateLimit-Reset: Unix timestamp when the limit resets

Response Format

All responses follow a standard envelope:

{
  "success": true,
  "data": { ... },
  "meta": { ... }
}

Error responses:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message"
  }
}

Data Sources

  • Tariff rates: Australian Border Force Working Tariff Schedule 3
  • FTA rates: DFAT FTA Portal (17 agreements)
  • Exchange rates: Reserve Bank of Australia
  • HS classification: AI-powered (Claude + Fuse.js fuzzy matching)

Production

Client Libraries
Shell Curl

Countries

​

Country list with FTA coverage for Australian imports

Countries Operations

List all countries

​

Returns all 261 countries with their Australian FTA coverage. Use query parameters to filter by name or FTA membership.

Query Parameters
  • search
    Type: string

    Filter by country name or code (case-insensitive substring match)

  • fta
    Type: string

    Filter to countries covered by a specific FTA code

  • has_fta
    Type: stringenum

    Filter to countries with (true) or without (false) any FTA coverage

    • true
    • false
Responses
Request Example for get/api/tariff/countries
curl https://app.starshipper.io/api/tariff/countries \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'

{
  "success": true,
  "data": [
    {
      "countryCode": "CHN",
      "countryName": "China",
      "ftas": [
        "ChAFTA",
        "RCEP"
      ]
    },
    {
      "countryCode": "NZL",
      "countryName": "New Zealand",
      "ftas": [
        "ANZCERTA",
        "RCEP",
        "CPTPP",
        "AANZFTA"
      ]
    },
    {
      "countryCode": "BRA",
      "countryName": "Brazil",
      "ftas": []
    }
  ],
  "meta": {
    "total": 261,
    "filtered": 261
  }
}

Successful response

Tariff Rates (Collapsed)

​

Australian tariff rates from the ABF Working Tariff Schedule 3

Tariff Rates Operations

Classification (Collapsed)

​

AI-powered HS code classification

Classification Operations

Free Trade Agreements (Collapsed)

​

Australia's 17 FTAs with preferential duty rates

Free Trade Agreements Operations

Data Quality (Collapsed)

​

Data freshness, sources, and build metadata

Data Quality Operations

Exchange Rates (Collapsed)

​

RBA exchange rates (AUD base) for duty calculations

Exchange Rates Operations

Models