Skip to main content

ShipHawk API Endpoints

The ShipHawk API endpoints the integration calls, grouped by entity, for allowlisting, troubleshooting, and deprecation tracking.

This document lists the ShipHawk API endpoints the integration calls. It is useful for firewall allowlisting, API troubleshooting, and understanding which ShipHawk endpoints a deprecation notice might affect.

API Endpoints Intro

ShipHawk provides a REST API. In the patterns below, [Base URL] is the ShipHawk API URL configured on your iPaaS.com subscription — the tenant-specific URL ShipHawk provides for your account, in the form https://[tenant].tms.myshiphawk.com (for example, https://sandbox-example.tms.myshiphawk.com for a sandbox). Endpoints use the /api/v4/ path.

Table of Contents

  • Order Endpoints

  • Shipment Endpoints

  • Webhook Endpoints

Order Endpoints

Get an Order (GET)

[Base URL]/api/v4/orders/{Id}

Used during FROM iPaaS.com transfers to retrieve an existing ShipHawk order (for example, to locate an order before an update or when reconciling a duplicate order number), where {Id} is the ShipHawk order identifier.

Create an Order (POST)

[Base URL]/api/v4/orders

Used during FROM iPaaS.com transfers to create a new order in ShipHawk.

Update an Order (POST)

[Base URL]/api/v4/orders/{Id}

Used during FROM iPaaS.com transfers to update an existing ShipHawk order, where {Id} is the ShipHawk order ID.

Shipment Endpoints

Get a Shipment by Id (GET)

[Base URL]/api/v4/shipments/{Id}

Used during shipment tracking transfers to retrieve a shipment from ShipHawk, where {Id} is the ShipHawk shipment ID.

Webhook Endpoints

Create a Webhook (POST)

[Base URL]/api/v4/webhooks

Registers the shipment tracking webhook in ShipHawk when the subscriber enables the tracking scope in iPaaS.com.

List Webhooks (GET)

[Base URL]/api/v4/webhooks

Retrieves the webhooks registered in ShipHawk.

Delete a Webhook (DELETE)

[Base URL]/api/v4/webhooks/{Id}

Removes a registered webhook from ShipHawk, where {Id} is the ShipHawk webhook ID.

Authorization

ShipHawk uses API Key authentication rather than a separate authorization endpoint. The API Key is sent with every request in the X-Api-Key header. The key is entered on the ShipHawk subscription settings in iPaaS.com and generated in the ShipHawk portal under Settings > Developer API.

Related Documents

Did this answer your question?