Skip to content

1. Setup

  • Base URL: https://api.staging.glsnxt.com/ooh-mock-service/v1, separate from the Carrier Integration API base URL.
  • Authentication: use your regular carrier staging X-API-Key, the same key you use for the Carrier Integration API. No separate mock-service key is needed.
  • Field names: mock service request bodies use snake_case (for example provider_locker_id), not the camelCase fields of the Carrier Integration API (for example lockerUid). The two are not interchangeable: the mock service works with provider-side identifiers, not platform identifiers.
  • Test values: provider, carrier, and locker values are test-specific. Use only the values GLS/NXT supplies for your account. Supported combinations vary by provider, carrier, shipment type, and event. Do not assume every combination works. Confirm your combination with GLS/NXT before testing.
  • Async by design: a successful 200 from any mock endpoint confirms only that the request was accepted. The actual status change arrives afterwards through your webhooks. The response body never contains the full simulated lifecycle.
  • Use a unique parcel ID for every test.