Overview

Welcome to the Gozem Courier API

The Courier API lets partners add on-demand delivery to their applications over a REST interface. You can request delivery options, price a delivery, book and manage trips, follow them to completion, and pull invoices.

This section covers everything specific to the Courier API. For the platform foundations every service shares, see the Platform section: getting set up and your environments in Environments & Access, getting a token in Authentication, and the shared conventions in API Basics and Webhooks.

What you can do

• Retrieve the vehicle types available in a given area
• Price a proposed delivery with a quote
• Book and manage delivery trips
• Follow a trip’s progress and status changes
• Exchange messages with the driver during a trip
• Retrieve invoices and delivery history

Who it is for

The Courier API suits partners who need delivery inside their own systems: adding delivery to an e-commerce or ordering flow, automating deliveries for internal operations, or supporting marketplace and logistics workflows. It handles both lightweight integrations and high-volume production use.

How an integration flows

Most integrations follow the same path:

1. Choose an available vehicle type for the pickup area.
2. Create a quote to price the delivery.
3. Book a trip.
4. Follow the trip through its lifecycle, using webhooks.
5. Retrieve the invoice once the trip completes.

Each step maps to a dedicated endpoint, documented in the API Reference. To make your first calls and follow a complete delivery end to end, start with the Getting Started guide.

Base URL

Courier endpoints sit under the /courier service path, with a version segment. The two environments differ only by host:

# Production
https://api.gozem.co/courier/v1

# Sandbox
https://sandbox-api.gozem.co/courier/v1

A note on sandbox

The Courier API behaves differently in sandbox than in production, because sandbox has no live drivers. A booked trip does not progress on its own, and the trip lifecycle events do not fire by themselves. The Getting Started guide explains how to drive a sandbox trip through its lifecycle so you can test tracking and webhooks end to end.

Reference collection

The endpoints are also available as an importable API collection you can load into your REST client, alongside the per-endpoint reference in this section. You can obtain it from the Partner Portal.