For developers

One API for logistics. Typed SDK. Real sandbox.

Rates, orders, shipments, tracking, returns, and webhooks behind a single versioned /v1 API — with a fully-typed TypeScript SDK, publishable and secret keys, and a sandbox where nothing moves real money. Build against it today.

quote.ts
import { TLDP } from '@tybrite-labs/tldp-sdk';
const client = new TLDP({ apiKey: 'tybrite_pk_test_…' });
const { quotes } = await client.rates.calculateRates({
requestBody: {
origin: { city: 'Eastport' },
destination: { city: 'Westhaven' },
weight_kg: 2.5, service_level: 'standard',
},
});
// each quote: quote_id, courier_name, total_price

Everything you need, under one base URL.

BASEhttps://api.tybritelabs.com/logistics/v1
/v1/rates

Calculate live quotes by city, named zone, coordinates, or place name; list zones.

/v1/orders

Create, list, get, update, cancel, and fulfil; on-demand quote and fulfil.

/v1/shipments

Create, get, and cancel shipments directly.

/v1/tracking

Track a shipment (public, no auth) plus detailed tracking events.

/v1/pod

Retrieve proof of delivery — photo, OTP, or signature — for a shipment.

/v1/returns

Request, list, get, approve, reject, receive, and resolve returns.

/v1/webhooks

Create, list, delete, and test webhook endpoints.

/v1/health

Health checks and API info.

A typed SDK that does the boring parts for you.

@tybrite-labs/tldp-sdk is a fully-typed TypeScript SDK (MIT) with built-in idempotency keys and automatic retry/backoff, throwing typed errors you can handle. Install, drop in a key, and call.

$npm i @tybrite-labs/tldp-sdk
order.ts
// Create an order — secret key, backend only.
const { order } = await client.orders.createOrder({
requestBody: {
reference: 'ORDER-1042',
delivery_method: 'last_mile',
recipient: { name: 'A. Rivera', city: 'Eastport' },
item: { description: 'Books', weight_kg: 1.2 },
},
});
// Fulfil with a chosen quote.
const shipment = await client.orders.fulfilOrder({
orderId: order.id,
requestBody: { rate_quote_id: quotes[0].quote_id },
});

Two key types. A sandbox that costs nothing.

tybrite_pk_…
Publishable keys

Read-only and safe on the client — rates and tracking.

tybrite_sk_…
Secret keys

Read/write for your backend — orders, shipments, returns, webhooks.

Test vs live

A …_test_… key runs entirely in sandbox — isolated data, no money moves, events flagged as test. Build and verify the whole flow before you flip to live.

Know the moment something happens.

Subscribe an endpoint and TLDP posts events as they occur — order.*, shipment.*, payment.*, dispute.*, and return.refunded. Verify each with the TLDP-Signature header (HMAC-SHA256 over timestamp.body); every event carries livemode so test and live never mix.

Safe to retry. Hard to double-charge.

Every write accepts an Idempotency-Key — retry a create as often as you like and it happens once. The SDK adds one for you and backs off automatically on transient errors. Versioned /v1 means your integration doesn't break under you.

Build logistics into your product today.

Grab test keys, build in sandbox, ship when you're ready. The complete reference, quickstarts, and examples live in the docs.