Edit a Shipment

PATCH

shipments

{id}

curl --request PATCH \
  --url https://api.terminal49.com/v2/shipments/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "attributes": {
      "ref_numbers": [
        "REFNUMBER10"
      ],
      "shipment_tags": [
        "tag1, tag2"
      ]
    }
  }
}'

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "relationships": {
      "destination": {
        "data": {
          "type": "port",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "port_of_lading": {
        "data": {
          "type": "port",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "containers": {
        "data": [
          {
            "type": "container",
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
          }
        ]
      },
      "port_of_discharge": {
        "data": {
          "type": "port",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "pod_terminal": {
        "data": {
          "type": "terminal",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "destination_terminal": {
        "data": {
          "type": "terminal",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "line_tracking_stopped_by_user": {
        "data": {
          "type": "user",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      }
    },
    "attributes": {
      "bill_of_lading_number": "<string>",
      "normalized_number": "<string>",
      "ref_numbers": [
        "<string>"
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "tags": [
        "<string>"
      ],
      "port_of_lading_locode": "<string>",
      "port_of_lading_name": "<string>",
      "port_of_discharge_locode": "<string>",
      "port_of_discharge_name": "<string>",
      "destination_locode": "<string>",
      "destination_name": "<string>",
      "shipping_line_scac": "<string>",
      "shipping_line_name": "<string>",
      "shipping_line_short_name": "<string>",
      "customer_name": "<string>",
      "pod_vessel_name": "<string>",
      "pod_vessel_imo": "<string>",
      "pod_voyage_number": "<string>",
      "pol_etd_at": "2023-11-07T05:31:56Z",
      "pol_atd_at": "2023-11-07T05:31:56Z",
      "pod_eta_at": "2023-11-07T05:31:56Z",
      "pod_original_eta_at": "2023-11-07T05:31:56Z",
      "pod_ata_at": "2023-11-07T05:31:56Z",
      "destination_eta_at": "2023-11-07T05:31:56Z",
      "destination_ata_at": "2023-11-07T05:31:56Z",
      "pol_timezone": "<string>",
      "pod_timezone": "<string>",
      "destination_timezone": "<string>",
      "line_tracking_last_attempted_at": "2023-11-07T05:31:56Z",
      "line_tracking_last_succeeded_at": "2023-11-07T05:31:56Z",
      "line_tracking_stopped_at": "2023-11-07T05:31:56Z",
      "line_tracking_stopped_reason": "all_containers_terminated"
    },
    "type": "shipment",
    "links": {
      "self": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

Token YOUR_API_TOKEN

The APIs require authentication to be done using header-based API Key and Secret Authentication.

API key and secret are sent va the Authorization request header.

You send your API key and secret in the following way:

Authorization: Token YOUR_API_KEY

Path Parameters

string

required

Shipment Id

Body

application/json

data

object

data.attributes

object

required

Response

200 - application/json

data

object

data.id

string

required

data.relationships

object

required

data.relationships.destination

object

data.relationships.port_of_lading

object

data.relationships.containers

object

data.relationships.port_of_discharge

object

data.relationships.pod_terminal

object

data.relationships.destination_terminal

object

data.relationships.line_tracking_stopped_by_user

object

data.attributes

object

required

data.attributes.bill_of_lading_number

string

required

data.attributes.normalized_number

string

The normalized version of the shipment number used for querying the carrier

data.attributes.ref_numbers

string[] | null

data.attributes.created_at

string

data.attributes.tags

string[]

data.attributes.port_of_lading_locode

string | null

UN/LOCODE

data.attributes.port_of_lading_name

string | null

data.attributes.port_of_discharge_locode

string | null

UN/LOCODE

data.attributes.port_of_discharge_name

string | null

data.attributes.destination_locode

string | null

UN/LOCODE

data.attributes.destination_name

string | null

data.attributes.shipping_line_scac

string

data.attributes.shipping_line_name

string

data.attributes.shipping_line_short_name

string

data.attributes.customer_name

string | null

data.attributes.pod_vessel_name

string | null

data.attributes.pod_vessel_imo

string | null

data.attributes.pod_voyage_number

string | null

data.attributes.pol_etd_at

string | null

data.attributes.pol_atd_at

string | null

data.attributes.pod_eta_at

string | null

data.attributes.pod_original_eta_at

string | null

data.attributes.pod_ata_at

string | null

data.attributes.destination_eta_at

string | null

data.attributes.destination_ata_at

string | null

data.attributes.pol_timezone

string | null

IANA tz

data.attributes.pod_timezone

string | null

IANA tz

data.attributes.destination_timezone

string | null

IANA tz

data.attributes.line_tracking_last_attempted_at

string | null

When Terminal49 last tried to update the shipment status from the shipping line

data.attributes.line_tracking_last_succeeded_at

string | null

When Terminal49 last successfully updated the shipment status from the shipping line

data.attributes.line_tracking_stopped_at

string | null

When Terminal49 stopped checking at the shipping line

data.attributes.line_tracking_stopped_reason

enum<string> | null

The reason Terminal49 stopped checking

Available options:

all_containers_terminated,

past_arrival_window,

no_updates_at_line,

cancelled_by_user,

booking_cancelled

data.type

enum<string>

required

Available options:

shipment

data.links

object

required

Get a shipment Stop tracking a shipment

curl --request PATCH \
  --url https://api.terminal49.com/v2/shipments/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "attributes": {
      "ref_numbers": [
        "REFNUMBER10"
      ],
      "shipment_tags": [
        "tag1, tag2"
      ]
    }
  }
}'

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "relationships": {
      "destination": {
        "data": {
          "type": "port",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "port_of_lading": {
        "data": {
          "type": "port",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "containers": {
        "data": [
          {
            "type": "container",
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
          }
        ]
      },
      "port_of_discharge": {
        "data": {
          "type": "port",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "pod_terminal": {
        "data": {
          "type": "terminal",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "destination_terminal": {
        "data": {
          "type": "terminal",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      },
      "line_tracking_stopped_by_user": {
        "data": {
          "type": "user",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      }
    },
    "attributes": {
      "bill_of_lading_number": "<string>",
      "normalized_number": "<string>",
      "ref_numbers": [
        "<string>"
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "tags": [
        "<string>"
      ],
      "port_of_lading_locode": "<string>",
      "port_of_lading_name": "<string>",
      "port_of_discharge_locode": "<string>",
      "port_of_discharge_name": "<string>",
      "destination_locode": "<string>",
      "destination_name": "<string>",
      "shipping_line_scac": "<string>",
      "shipping_line_name": "<string>",
      "shipping_line_short_name": "<string>",
      "customer_name": "<string>",
      "pod_vessel_name": "<string>",
      "pod_vessel_imo": "<string>",
      "pod_voyage_number": "<string>",
      "pol_etd_at": "2023-11-07T05:31:56Z",
      "pol_atd_at": "2023-11-07T05:31:56Z",
      "pod_eta_at": "2023-11-07T05:31:56Z",
      "pod_original_eta_at": "2023-11-07T05:31:56Z",
      "pod_ata_at": "2023-11-07T05:31:56Z",
      "destination_eta_at": "2023-11-07T05:31:56Z",
      "destination_ata_at": "2023-11-07T05:31:56Z",
      "pol_timezone": "<string>",
      "pod_timezone": "<string>",
      "destination_timezone": "<string>",
      "line_tracking_last_attempted_at": "2023-11-07T05:31:56Z",
      "line_tracking_last_succeeded_at": "2023-11-07T05:31:56Z",
      "line_tracking_stopped_at": "2023-11-07T05:31:56Z",
      "line_tracking_stopped_reason": "all_containers_terminated"
    },
    "type": "shipment",
    "links": {
      "self": "<string>"
    }
  }
}

Getting Started

In Depth Guides

Useful Info

Shipments

Tracking Requests

Webhooks

Webhook Notifications

Containers

Shipping Lines

Metro Areas

Ports

Vessels

Terminals

Parties

Authorizations

Path Parameters

Body

Response