Gozem Developer DocsDocs

Courier API

13 operations across 4 resource groups. Spec version 0.0.0.

Base URLhttps://sandbox-api.gozem.co/courier
AuthenticationAPI key (x-api-key) or Bearer token

Every request needs a credential — an OAuth2 bearer token or a long-lived API key. SeeAuthentication for how to get one, andEnvironments & Access for sandbox versus production.

Vehicle

Discover the vehicle/service types available for a delivery.

Quote

Price a delivery up front and reuse the quote when booking a trip.

Simulation

Sandbox-only helpers that let clients drive a trip through its full lifecycle events without a real driver.

Errors

Every operation in this service returns the same failure envelope. Branch oncode: it is the stable, machine-readable contract. error is the HTTP class name and message is human-facing text that may be reworded or localized — do not branch on either. Handle an unrecognized code gracefully by falling back to the HTTP status.

codestringrequired

Stable, machine-readable error code. Branch on this. See the Error Codes reference in the API description.

detailsarray of object

Field-level validation failures. Present on `validation_failed` only.

object
fieldstringrequired

Dotted path to the offending field.

messagestringrequired

Why the field was rejected.

messagestringrequired

Human-readable message. May be reworded or localized — do not branch on it.

successbooleanrequired

Always `false` on an error response.

false

Status codes

These are returned across the service:

200400401403404405409413415429500502