Skip to main content

Welcome to ColisMove API

ColisMove is a peer-to-peer parcel transport platform (like BlaBlaCar, but for parcels). Travelers with available luggage space can transport parcels for senders along their route.

Core Concepts

Announcements

Verified carriers create transport announcements specifying their route, dates, and available capacity.

Bookings

Senders book space on announcements to ship their parcels. The full lifecycle is managed through a state machine.

Payments

Secure payments via Stripe Connect with platform escrow. Carriers receive funds only after confirmed delivery.

Agencies

Professional transport agencies can register, manage branches, employees, and handle bulk shipments.

How It Works

Base URL

All API endpoints are prefixed with:
https://api.colismove.com/v1/api
For local development:
http://localhost:3091/v1/api

Quick Start

1

Register an account

Create a user account via POST /v1/api/auth/register
2

Authenticate

Login to get your JWT tokens via POST /v1/api/auth/login
3

Complete KYC

Verify your identity via POST /v1/api/kyc/init to unlock carrier features
4

Start using the API

Browse announcements, create bookings, or create your own announcements