SDKs

Every SDK is generated from the same OpenAPI document as the API reference, with a thin hand-written layer on top for idempotency, problem+json errors, retries and webhook verification.

TypeScript

npm install @freightapi/sdk

import { FreightApi, FreightApiError } from '@freightapi/sdk'

const freight = new FreightApi({
  apiKey: process.env.FREIGHTAPI_KEY!,
  baseUrl: 'https://api.eftisandbox.app',
  locale: 'en',
})

try {
  const shipment = await freight.shipments.retrieve('shp_...')
  console.log(shipment.status)
} catch (error) {
  if (error instanceof FreightApiError) {
    console.error(error.status, error.code, error.requestId)
  }
}

Runs on Node 22+, Bun, Deno, Cloudflare Workers and in the browser. Zero runtime dependencies. Every POST gets an Idempotency-Key automatically, and 429 and 503 are retried.

.NET

On the way

The official .NET SDK arrives with M3-17. Until then Cargofollow is a plain REST API: generate a client from /openapi.json with NSwag or Kiota, or use HttpClient with System.Text.Json as in the quickstart.

Other languages

There is no official client for Python, Java, PHP or Go. The OpenAPI document is 3.1 and complete, so generators such as openapi-generator or openapi-python-client produce a working client:

curl -o openapi.json https://api.eftisandbox.app/openapi.json