Get Delivery E-URL
This API returns a shareable eURL for a delivery. The URL can be shared with customers/partners to get detailed information about the delivery and its tracking information.
📘 Token behaviour
- templateId embeds differently into the encrypted token — the same delivery with vs. without templateId will produce different token values.
- The identifierType=deliveryIdentifier path also produces a different token from the UUID path, since the identifier is embedded in the encrypted payload.
- Each call generates a fresh requestId — two calls to the same delivery return different requestId values but the same data eURL (the token is deterministic for a given delivery + companyId + templateId + identifierType combination).
curl --location -g --request GET 'https://api.fourkites.com/delivery/{deliveryId}/fourkites-tracking-url?identifierType={identifierType}&templateId={templateId}' \
--header 'apikey: REPLACE_KEY_VALUE'
curl --location -g --request GET 'https://api-staging.fourkites.com/delivery/{deliveryId}/fourkites-tracking-url?identifierType={identifierType}&templateId={templateId}' \
--header 'apikey: REPLACE_KEY_VALUE'
Request Attributes
Name | Param Type | Format | Default | Description |
|---|---|---|---|---|
deliveryId | Path | String | NA | FourKites delivery UUID (PK) or delivery identifier string. Required. |
identifierType | Query | String | Auto-detected | Resolution hint. deliveryId forces UUID/PK lookup; deliveryIdentifier forces identifier string lookup. Omit for auto-detection. Optional. |
templateId | Query | String | Company's default template | FourKites-generated identifier for an eURL template. Optional. |
Response Attributes
Name | Format | Default | Description |
|---|---|---|---|
data | String. Fully formed URL. | NA | Shareable delivery eURL. Path contains /inventory/deliveries/eurl/. Can be shared or embedded in HTML iframes. |
requestId | String (UUID) | NA | Per-request correlation ID — unique on every call, written to MDC (searchable in Kibana). |