Platform Integration

Comprehensive Features. One Powerful Platform.

Every operation in DepotLite is available through a well-documented platform. From gate-in to invoicing, from EDI generation to analytics — build integrations that fit your workflow.

Get API Key Explore Categories

Complete

Platform

Secure Authentication

DepotLite supports both session-based and token-based authentication. Web users get seamless cookie-based sessions while integration consumers use standard Bearer tokens with automatic refresh.

HTTP-only cookies with CSRF protection for web

Access tokens (15min) + refresh tokens (7 days)

10 role-based access levels with permissions

Rate limiting with configurable thresholds

Authentication Flow

// 1. Obtain token
POST /v1/auth/login
{
  "email": "ops@liner.com",
  "password": "****",
  "type": "api"  // returns tokens
}

// Response
{
  "accessToken": "eyJhbGci...",
  "refreshToken": "dGhpcyBp...",
  "expiresIn": 900,
  "role": "liner_admin"
}

// 2. Use in requests
Authorization: Bearer eyJhbGci...

// 3. Refresh when expired
POST /v1/auth/refresh
{ "refreshToken": "dGhpcyBp..." }

API Categories

10 Categories, Every Operation Covered

From authentication to analytics, every aspect of container depot management is accessible through a clean, consistent REST interface.

Authentication

8 endpoints

Journey Management

20+ endpoints

Gate-in, gate-out, pre-advise, survey, estimation, approval, repair tracking, and status transitions. The core of depot operations.

Container Management

15 endpoints

Container registration, status tracking, stock queries by grade/size/liner, history lookup, and BoxTech data enrichment.

Liner Approval Portal

12 endpoints

Estimation review, approve/reject workflows, bulk approval, comment threads, and approval history. Built for shipping line users.

Master Data

18 endpoints

Liners, depots, tariffs, component codes, repair codes, damage codes, locations, and user management with role-based access.

EDI Generation

8 endpoints

CODECO EDIFACT generate, parse, validate, bulk generate, and per-liner configuration management in D95B and D00B formats.

Invoicing

14 endpoints

Invoice creation, Zoho Books sync, PDF generation, tax calculation (CGST/SGST), payment tracking, and credit note management.

Reporting

16 endpoints

Stock reports, revenue analytics, turnaround time analysis, liner performance, aging reports, and custom date-range queries.

Search & Analytics

12 endpoints

Full-text container search, journey search with filters, advanced analytics queries, and aggregation endpoints for dashboards.

File Management

15 endpoints

Survey photo uploads, document attachments, secure cloud storage, controlled access, and bulk file operations.

Example

See It in Action

A real API call to search container journeys with filters. Every response follows a consistent structure with pagination, error handling, and typed data.

RequestPOST

// Fetch container journey status
const response = await fetch(
  "https://api.depotlite.com/v1/journeys/search",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer eyJhbGciOiJSUzI1...",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      containerNumber: "MSCU1234567",
      status: ["GATE_IN", "UNDER_REPAIR"],
      linerId: "MSC",
      page: 1,
      limit: 10
    })
  }
);

Response200 OK

{
  "success": true,
  "data": {
    "items": [
      {
        "journeyId": "j_8f3k2m1n",
        "containerNumber": "MSCU1234567",
        "liner": { "id": "MSC", "name": "Mediterranean Shipping" },
        "status": "UNDER_REPAIR",
        "gateInDate": "2026-03-18T09:30:00Z",
        "condition": "DAMAGED",
        "estimationTotal": 1250.00,
        "approvalStatus": "APPROVED",
        "assignedBay": "B-14",
        "depot": { "id": "depot_maa01", "name": "Chennai CFS" }
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 10
  }
}

FAQ

Common API Questions

Everything you need to know about authentication, rate limits, versioning, and access control.

DepotLite uses secure session-based authentication for web dashboard users and token-based authentication for integrations. Web sessions are managed via secure cookies with protection against common attacks, while integration consumers receive an access token (15min) and refresh token (7 days) pair. Both methods share the same role-based permission system with 10 access levels.

The roles are: Super Admin, Depot Owner, Depot Manager, Depot Operator, Gate Officer, Survey Inspector, Repair Supervisor, Finance Manager, Liner Admin, and Liner Viewer. Each role has specific endpoint-level permissions that control read/write access to resources.

Standard API keys allow 1,000 requests per minute. Enterprise plans offer configurable limits up to 10,000 requests per minute. Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response.

Yes. All endpoints are versioned under /v1/. Breaking changes are released under new version prefixes. Non-breaking additions (new fields, new endpoints) are added to the current version without a version bump.

Ready to Integrate?

Get your API key and start building. Full documentation, TypeScript types, and example code included.

Developer Portal Request API Access