# TLDP Docs

## Docs

- [TLDP: Africa's Unified Logistics Developer Platform](https://tldp.tybritelabs.com/docs/introduction.md): TLDP gives you a single REST API and TypeScript SDK to quote rates, create shipments, track deliveries, and manage returns across African courier networks.
- [TLDP Quickstart: Quote, Ship, and Track in 5 Steps](https://tldp.tybritelabs.com/docs/quickstart.md): Install the TLDP SDK, initialise your client, quote delivery rates, create and fulfil an order, and track your shipment in one end-to-end walkthrough.
- [TLDP API Authentication: Keys, Environments, and Security](https://tldp.tybritelabs.com/docs/authentication.md): TLDP uses Bearer API keys to authenticate every request. Understand key types, test vs live environments, and how to pass credentials securely.
- [API Keys and Environments in TLDP](https://tldp.tybritelabs.com/docs/concepts/keys-and-environments.md): Understand TLDP's secret and publishable key types, how test and live environments differ, and how to keep your credentials secure.
- [Orders and Shipments: TLDP Data Model Explained](https://tldp.tybritelabs.com/docs/concepts/orders-and-shipments.md): Learn how TLDP separates commercial intent (orders) from physical delivery (shipments) and when to use each resource in your integration.
- [Rates, Quotes, and Service Levels in TLDP](https://tldp.tybritelabs.com/docs/concepts/rates-and-service-levels.md): Learn how to fetch competitive courier quotes, compare service levels and courier tiers, and lock in a price before fulfilling an order.
- [Shipment Tracking Lifecycle and Status Events](https://tldp.tybritelabs.com/docs/concepts/tracking-lifecycle.md): Understand every shipment status in TLDP, how to track deliveries in real time, and the difference between public and detailed tracking.
- [Create and Track a Shipment with TLDP](https://tldp.tybritelabs.com/docs/guides/create-a-shipment.md): Step-by-step guide to quoting, creating, and tracking a shipment via the order flow or directly using the TLDP REST API and TypeScript SDK.
- [Manage Returns and Exchanges with TLDP](https://tldp.tybritelabs.com/docs/guides/manage-returns.md): Handle the complete returns lifecycle — from customer request through approval, physical receipt, and final resolution — using the TLDP API and TypeScript SDK.
- [Retrieve Proof of Delivery for TLDP Shipments](https://tldp.tybritelabs.com/docs/guides/proof-of-delivery.md): Fetch and verify proof-of-delivery records for delivered shipments, including photo, OTP, and signature evidence captured at the point of handoff.
- [Receive Realtime Events with TLDP Webhooks](https://tldp.tybritelabs.com/docs/guides/webhooks.md): Set up webhook endpoints, verify signatures, and reliably handle TLDP events for orders, shipments, payments, and returns in realtime.
- [TLDP TypeScript SDK: Fully Typed Logistics Client](https://tldp.tybritelabs.com/docs/sdk/introduction.md): Install and configure @tybrite-labs/tldp-sdk — a fully typed TypeScript client for the TLDP REST API covering orders, shipments, tracking, and more.
- [OrdersService: Create and Fulfil Orders | TLDP SDK](https://tldp.tybritelabs.com/docs/sdk/orders.md): Use client.orders to create, update, fulfil, and cancel orders — including on-demand fulfilment and real-time courier quotes via the TLDP SDK.
- [ShipmentsService: Create and Manage Shipments | TLDP](https://tldp.tybritelabs.com/docs/sdk/shipments.md): Use client.shipments to create, retrieve, and cancel shipments directly — ideal for B2B, bulk, or headless workflows that skip the order layer.
- [RatesService: Courier Quotes and Delivery Zones | TLDP](https://tldp.tybritelabs.com/docs/sdk/rates.md): Use client.rates to fetch competitive courier quotes for any route and list all supported delivery zones across the TLDP courier network.
- [TrackingService: Public and Detailed Shipment Tracking](https://tldp.tybritelabs.com/docs/sdk/tracking.md): Use client.tracking for public customer-facing shipment status or detailed backend event history — each method requires a different API key type.
- [ReturnsService: Handle Returns and Exchanges | TLDP](https://tldp.tybritelabs.com/docs/sdk/returns.md): Use client.returns to request, approve, receive, and resolve returns and exchanges through the full TLDP reverse-logistics lifecycle.
- [WebhooksService: Subscribe to Platform Events | TLDP](https://tldp.tybritelabs.com/docs/sdk/webhooks.md): Use client.webhooks to create, list, test, and delete webhook endpoints that receive real-time TLDP order, shipment, payment, and return events.
- [ProofOfDeliveryService: Get Proof of Delivery | TLDP](https://tldp.tybritelabs.com/docs/sdk/proof-of-delivery.md): Use client.proofOfDelivery to retrieve photo, OTP, or signature proof of delivery records once a shipment reaches delivered status.
- [TLDP REST API Reference: Endpoints and Conventions](https://tldp.tybritelabs.com/docs/api-reference/introduction.md): Explore the TLDP REST API at api.tybritelabs.com/v1 — base URL, authentication, JSON conventions, idempotency, error codes, and rate limits.