# Gozem Developer Docs > Guides and reference for building on the Gozem platform: delivery (Courier API) > across West and Central Africa. API services are reached at `https://sandbox-api.gozem.co/{service}/v1` in sandbox and `https://api.gozem.co/{service}/v1` in production. OAuth2 tokens come from `sandbox-auth.gozem.co` / `auth.gozem.co`. ## Guides ### Platform - [Introduction](https://developers.gozem.co/docs/platform/introduction): Welcome to the Gozem Developer Platform. - [Environments & Access](https://developers.gozem.co/docs/platform/environments): This page covers the two environments the platform runs in, and how to get set up with an API client and credentials in the Partner Portal. - [Authentication](https://developers.gozem.co/docs/platform/authentication): Every request to a Gozem API must be authenticated. You have two options: a short-lived OAuth2 access token, or a long-lived API key. Use exactly one per req… - [API Basics](https://developers.gozem.co/docs/platform/api-basics): This page covers the conventions every Gozem API shares: how versioning works, how list endpoints paginate, how errors are returned, and how rate limiting b… - [Webhooks](https://developers.gozem.co/docs/platform/webhooks): Webhooks let your system receive real-time notifications when events occur on the Gozem platform, so you can run event-driven integrations instead of polling… - [Platform Status & Support](https://developers.gozem.co/docs/platform/status-support): This page covers how to check platform health and how to reach the support team. ### API Services #### Courier API - [Overview](https://developers.gozem.co/docs/api-services/courier/overview): 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 an… - [Concepts](https://developers.gozem.co/docs/api-services/courier/concepts): The core entities of the Courier API and how they relate: the data structures behind delivery options, pricing, and trip execution. - [Getting Started](https://developers.gozem.co/docs/api-services/courier/getting-started): A complete delivery from credentials to invoice: choose a vehicle, price it, book it, follow it through webhooks, and pull the invoice. Includes how to test the full lifecycle in sandbox. - [Trip Lifecycle & Events](https://developers.gozem.co/docs/api-services/courier/lifecycle-events): Every trip status, what triggers each change, which states are terminal, and the full list of webhook events the Courier API emits. - [Errors](https://developers.gozem.co/docs/api-services/courier/errors): This page lists the error codes specific to the Courier API. The error response shape, the rule to branch on the code field, and the platform-wide codes (suc… #### Money API - [Overview](https://developers.gozem.co/docs/api-services/money/overview): The Gozem Money API lets partner systems move money across the Gozem ecosystem and supported Payment Service Providers: create charges, send payouts, inspect transactions, and read account information. - [Concepts](https://developers.gozem.co/docs/api-services/money/concepts): The core entities of the Money API and how they relate: merchant accounts, charges, payouts, transactions, channels, and the response envelope behind them. - [Authentication](https://developers.gozem.co/docs/api-services/money/authentication): How the Money API authenticates every request: an OAuth2 bearer token plus a per-request HMAC signature, the authorization checks that follow, endpoint slugs, and idempotency. - [Payments Lifecycle & Events](https://developers.gozem.co/docs/api-services/money/lifecycle-events): Every charge and payout status, which states are terminal, and the full set of webhook events the Money API emits when a transaction settles. - [Errors](https://developers.gozem.co/docs/api-services/money/errors): The error codes specific to the Money API, the failure envelope they use, and how it relates to the platform-wide codes. - [Endpoints](https://developers.gozem.co/docs/api-services/money/endpoints): The complete Money API endpoint reference: charges, payouts, transaction details, and account, with request and response detail for each call. ## Recipes - [Recipes index](https://developers.gozem.co/docs/recipes) ### Deliver a package end to end https://developers.gozem.co/docs/recipes/deliver-a-package Pick a vehicle, price the delivery, book the trip, then read the trip and its invoice once it lands. 1. Find out what can carry it 2. Price the delivery 3. Book it 4. Read the trip when you need detail 5. Pull the invoice ### Drive a trip through its lifecycle https://developers.gozem.co/docs/recipes/simulate-a-trip Advance a sandbox trip from pending to completed yourself, so every webhook fires without waiting for a real courier. 1. Book a trip 2. Walk it forward 3. Confirm where it landed 4. Then break it on purpose ### Verify a webhook signature https://developers.gozem.co/docs/recipes/verify-a-webhook-signature Read the raw bytes, compare the HMAC in constant time, then acknowledge before doing the work. 1. Read the raw bytes 2. Compare in constant time 3. Acknowledge, then work ## API Reference - [Reference index](https://developers.gozem.co/docs/reference) ### Courier API Base URL `https://sandbox-api.gozem.co/courier`. 13 operations. - [Courier API overview](https://developers.gozem.co/docs/reference/courier): all operations plus the shared error envelope. #### Vehicle - [GET /courier/v1/vehicles](https://developers.gozem.co/docs/reference/courier/list-vehicles): Get Available Vehicles: Fetch available vehicle and their operating zones. #### Quote - [POST /courier/v1/quotes](https://developers.gozem.co/docs/reference/courier/create-quote): Create Quote: Create a delivery trip quote. - [GET /courier/v1/quotes/{quote_id}](https://developers.gozem.co/docs/reference/courier/get-quote): Get Quote Details: Get details for a specific quote. #### Trip - [GET /courier/v1/trips](https://developers.gozem.co/docs/reference/courier/list-trips): List Trips: List past trips, optionally filtered by date or status. - [POST /courier/v1/trips](https://developers.gozem.co/docs/reference/courier/book-trip): Book a Trip: Create a new delivery trip. - [GET /courier/v1/trips/{trip_id}](https://developers.gozem.co/docs/reference/courier/get-trip): Get Trip Details: Fetch current status and details for a specific trip. - [POST /courier/v1/trips/{trip_id}/cancellation](https://developers.gozem.co/docs/reference/courier/cancel-trip): Cancel Trip: Cancel an active trip and process any applicable refunds. - [GET /courier/v1/trips/{trip_id}/invoice](https://developers.gozem.co/docs/reference/courier/get-trip-invoice): Get Trip Invoice: Fetch invoice details for a completed trip. - [GET /courier/v1/trips/{trip_id}/messages](https://developers.gozem.co/docs/reference/courier/get-trip-messages): Get Trip Messages: Retrieve the full message history between client and driver for a trip. - [POST /courier/v1/trips/{trip_id}/messages](https://developers.gozem.co/docs/reference/courier/send-trip-message): Send Trip Message: Send a message to the driver during an active trip. - [POST /courier/v1/trips/{trip_id}/rating](https://developers.gozem.co/docs/reference/courier/rate-trip): Rate Trip: Submit a rating and optional comment for a completed trip. - [GET /courier/v1/trips/stats](https://developers.gozem.co/docs/reference/courier/get-trip-stats): Get Trips Stats: Get summary stats about completed trips, distance, and earnings. #### Simulation - [POST /courier/v1/trips/{trip_id}/simulation/state](https://developers.gozem.co/docs/reference/courier/simulate-state-change): Simulate Trip State Change: Simulate trip state progression (assign driver, arrive at pickup, start trip, update location, complete trip). ### Money API Not yet generated, its endpoints are under review. The complete endpoint reference is at: - [Money endpoints](https://developers.gozem.co/docs/api-services/money/endpoints): all 8 Money operations. ## Other - [Articles](https://developers.gozem.co/articles) - [Request access](https://developers.gozem.co/apply)