SWALOO · OPERATIONS PLATFORM
STATUS: OPERATIONAL
··
REST API & Integrations

Integrate your logistics
without limits.

Full REST API in JSON-LD format, interactive OpenAPI documentation, API key authentication, and outbound webhooks. Connect Swaloo to all your systems in a few lines of code.

OpenAPI
Standard
API Key
Auth
Outbound
Webhooks
Request access→
Full REST API

All your data
accessible via API.

Every platform resource is exposed via a REST API in JSON-LD/Hydra format. Create, read, update, and delete your shipments, drivers, vehicles, and invoices programmatically with full control.

  • ◆JSON-LD/Hydra format compliant with semantic web standards
  • ◆Full CRUD on all resources: shipments, drivers, vehicles, zones
  • ◆Advanced filtering, sorting, and pagination on every endpoint
  • ◆Normalized responses with standard HTTP codes and structured error messages
  • ◆Support for nested relations and sub-resource expansion
PREVIEW · /API/DOCS
Create a shipment
POST
Request
curl -X POST \
  "https://api.swaloo.com/api/v1/shipments" \
  -H "X-API-Key: org_ak_7f3b..." \
  -H "Content-Type: application/ld+json" \
  -d '{ "recipient": "/api/v1/recipients/a1b2",
       "priority": "high",
       "codAmount": 45.00 }'
Response201 Created
{
  "@id": "/api/v1/shipments/c3d4e5",
  "trackingNumber": "SWL-20260422-047",
  "status": "pending",
  "priority": "high",
  "codAmount": 45.00,
  "createdAt": "2026-04-22T10:30:00+01:00"
}
OpenAPI documentation

Interactive documentation,
always up to date.

Swagger/OpenAPI documentation is auto-generated from the source code. Test every endpoint directly from the browser, explore data schemas, and generate client SDKs in the language of your choice.

  • ◆OpenAPI 3.1 specification auto-generated from PHP attributes
  • ◆Interactive Swagger UI to test endpoints live
  • ◆Detailed request and response schemas with examples
  • ◆Automatic SDK client generation (TypeScript, Python, PHP, etc.)
  • ◆API versioning to ensure backward compatibility
API Key authentication

Secure API key
per organization.

Each organization has a unique API key to authenticate its external integrations. The system enforces rate limiting per key, logs every call, and allows key rotation without service interruption.

  • ◆Unique API key auto-generated per organization
  • ◆Configurable rate limiting to protect against abuse
  • ◆Full logging of every API call (endpoint, timestamp, IP)
  • ◆One-click key rotation without disrupting active integrations
  • ◆Complementary JWT authentication for user sessions
Webhooks & Integrations

Real-time events
to your systems.

Configure outbound webhooks to receive instant notifications on every important event: shipment creation, delivery, return, etc. Each call is signed and automatically retried on failure.

  • ◆Outbound webhooks for all key events (creation, delivery, return, cancellation)
  • ◆Destination URLs configurable per organization and per event type
  • ◆HMAC-SHA256 signature to verify the authenticity of each notification
  • ◆Automatic retry logic with exponential backoff (3 attempts)
  • ◆Webhook log with delivery status and response time per call

See also

Related features

Multi-organization

Native multi-tenancy, granular roles, approval workflow, API key, and organization switching.

Multi-channel notifications

Email, SMS, push, and webhooks. Customizable templates with dynamic variables.

Billing & Subscriptions

Multi-tier subscriptions, automatic PDF invoices, multi-currency, and grace period management.

Stop operating in the dark.
Switch to smart logistics.

Set up your first optimized route in under 5 minutes. No credit card. No commitment.

Get started now →Book a demo
REST API & Integrations | Swaloo