Developer docs

Getting started

Build on Tarifflo from your own backend, or let an AI assistant work through the hosted MCP connector.

REST APIClassification, tariff rates, audit, export control, origin and entry filing over HTTPS.WebhooksSigned results POSTed to your server when an asynchronous job finishes.MCP connectorConnect Claude or any MCP client to the hosted Tarifflo connector.

1. Create an API key

Sign in to Tarifflo and open Developers → API keys. Choose the scopes the key needs and copy it: the full key is shown once. Keys start with tflo_live_ or tflo_test_. Only an organization owner can manage keys.

2. Make a request

The REST API is served from https://api.tarifflo.com and takes and returns JSON. Send the key in the X-API-Key header.

Classify a product

bash

curl -X POST "https://api.tarifflo.com/api/v1/classifications" \
  -H "X-API-Key: $TARIFFLO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Wireless over-ear headphones, plastic housing",
    "destinations": ["US"],
    "webhookUrl": "https://your-server.com/webhooks/tarifflo"
  }'

3. Get the result

Most endpoints are asynchronous. The request is validated right away and answers 202 Accepted with a jobId. When the job finishes, the result is POSTed to your webhookUrl, signed with your organization's webhook secret. You can also poll the matching GET endpoint with the jobId.

Next: read Authentication, then the REST API reference.