Build on DepotLite
API access is available exclusively to depots with an active DepotLite contract. A complete platform with comprehensive features across 10 categories, 9 role-based access levels, and real-time webhooks.
Complete
Platform
9
Role-Based Levels
Real-time
Webhook Events
Secure
JSON over HTTPS
Up and Running in 3 Steps
Get from zero to your first API call in minutes.
Get Your API Key
Contact our team to request API access. API credentials are issued exclusively to depots with an active DepotLite contract.
Make Your First Call
Authenticate and call any endpoint. Start with /v1/journeys/search to query container status or /v1/containers/stock for inventory.
Set Up Webhooks
Register a webhook URL to receive real-time events for gate-in, gate-out, approvals, EDI generation, and invoice creation.
10 Categories, Comprehensive Coverage
Every operation in the container depot lifecycle is accessible through a clean, versioned platform. 9 role-based access levels control what each user can read or write.
Authentication
Journey Management
Container Management
Liner Approval Portal
Master Data
EDI Generation
Invoicing
Reporting
Search & Analytics
File Management
Comprehensive coverage across all categories
Container Status Check
See how to query container status using TypeScript or curl. Every endpoint returns consistent JSON with typed responses.
import { DepotLite } from "@depotlite/sdk";
const client = new DepotLite({
apiKey: process.env.DEPOTLITE_API_KEY!,
baseUrl: "https://api.depotlite.com/v1",
});
// Check container status
async function getContainerStatus(containerNumber: string) {
const journey = await client.journeys.search({
containerNumber,
status: ["GATE_IN", "UNDER_REPAIR", "READY"],
limit: 1,
});
if (journey.data.items.length === 0) {
return { status: "NOT_FOUND" };
}
const container = journey.data.items[0];
return {
status: container.status,
liner: container.liner.name,
gateInDate: container.gateInDate,
condition: container.condition,
depot: container.depot.name,
estimationTotal: container.estimationTotal,
approvalStatus: container.approvalStatus,
};
}
const status = await getContainerStatus("MSCU1234567");
console.log(status);# Check container status
curl -X POST https://api.depotlite.com/v1/journeys/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"containerNumber": "MSCU1234567",
"status": ["GATE_IN", "UNDER_REPAIR", "READY"],
"limit": 1
}'
# Response
{
"success": true,
"data": {
"items": [{
"journeyId": "j_8f3k2m1n",
"containerNumber": "MSCU1234567",
"status": "UNDER_REPAIR",
"liner": { "name": "Mediterranean Shipping" },
"gateInDate": "2026-03-18T09:30:00Z",
"condition": "DAMAGED",
"estimationTotal": 1250.00,
"approvalStatus": "APPROVED",
"depot": { "name": "Chennai CFS" }
}],
"total": 1
}
}Real-Time Event Notifications
Subscribe to depot events and receive instant HTTP POST callbacks. HMAC-SHA256 signed for security.
journey.gate_inContainer has been gated in at the depotjourney.gate_outContainer has been gated out from the depotjourney.surveyedSurvey completed with damage assessmentjourney.estimatedRepair estimation created and ready for approvaljourney.approvedLiner approved the repair estimationjourney.rejectedLiner rejected the repair estimationjourney.repair_completeRepair work completed on the containeredi.generatedCODECO EDIFACT message generated and storedinvoice.createdNew invoice created for a journeyinvoice.paidPayment received and recorded for an invoicecontainer.registeredNew container registered in the systemapproval.reminderFollow-up reminder for pending approvalPOST https://your-app.com/webhooks/depotlite
Headers:
Content-Type: application/json
X-DepotLite-Signature: sha256=a1b2c3d4e5...
X-DepotLite-Event: journey.gate_in
{
"id": "evt_9k4m2n8p",
"event": "journey.gate_in",
"timestamp": "2026-03-24T09:30:00Z",
"data": {
"journeyId": "j_8f3k2m1n",
"containerNumber": "MSCU1234567",
"liner": "MSC",
"depot": "depot_maa01",
"condition": "DAMAGED",
"gateInDate": "2026-03-24T09:30:00Z"
}
}Secure Authentication
DepotLite uses a hybrid authentication system. Web dashboard users get secure cookie-based sessions. API consumers use Bearer tokens with automatic refresh. Both share the same 9-level role-based permission system.
Official SDKs Coming Soon
Type-safe client libraries that make integration even easier. The platform is available now.
TypeScript SDK
Fully typed client with auto-complete for every endpoint, request parameter, and response field. Built for Node.js, Deno, and edge runtimes.
Python SDK
Pythonic client with async support, Pydantic models, and comprehensive type hints. Ideal for data pipelines, analytics, and automation scripts.
Developer Questions
Common questions about API access, authentication, webhooks, and integration patterns.
API access is available exclusively to depots with an active DepotLite contract. Contact your account manager or reach out to our team at support@zitrino.com to request credentials. Once provisioned, you will authenticate via the /v1/auth/login endpoint.
DepotLite supports both browser-based dashboard access (using secure cookies) and token-based authentication for integrations and server-to-server communication. Both share the same role-based permission system.
Access tokens expire after 15 minutes. When you receive a 401 response, call POST /v1/auth/refresh with your refresh token to obtain a new access token. Refresh tokens are valid for 7 days. Store refresh tokens securely — they grant the same access level as the original login.
Yes. Each API key is tied to a user account with a specific role. You can create service accounts with read-only Liner Viewer access for reporting, or Depot Operator access for gate integrations. Contact your admin to set up role-specific service accounts.
Yes. Every webhook payload includes an X-DepotLite-Signature header containing an HMAC-SHA256 signature. Verify this against your webhook secret to ensure the payload is authentic and has not been tampered with.
Ready to Build?
Get your API key and start integrating DepotLite into your systems today. Full documentation, code samples, and webhook support included.