API changelog

The changes to the Globe API in each dated version, newest first. Versions explains how a request picks a version. Retiring a version is announced here before it happens.

Additions to 2026-10-01

Additive changes, available in version 2026-10-01 without a new version.

20 October 2026

• Orders and pickup points: GET /orders/{order_id}, PUT /orders/{order_id}/pickup-point, GET /orders/{order_id}/pickup-points. New scopes orders:read and pickup_points:read (every key has them) and pickup_points:assign; new error pickup_point_not_available.
• New scope labels:print replaces label_documents:read. POST /labels/{label_id}/printed needs labels:print instead of labels:write. Keys created before hold labels:print.
• Every key has carriers:read.

2026-10-01

The first version, released as a beta.

• Read labels and their PDFs: GET /labels, GET /labels/{label_id}, GET /labels/{label_id}/document, GET /orders/{order_id}/label-document, GET /label-documents.
• Create labels: POST /labels, GET /label-creations, GET /label-creations/{label_creation_id}, POST /label-creations/{label_creation_id}/resolve.
• Mark labels printed: POST /labels/{label_id}/printed.
• Carrier discovery: GET /carrier-accounts, GET /carrier-accounts/{carrier_account_id}.
• Store and key: GET /shop.
• Webhook topic label_creation.updated.