Door-to-Airport

6 min

Create a Door-to-Airport load with Origin and destination airport stop types along with the Pickup stop type as the first leg.

⚠️ Important Update:

The Pallets structure is being deprecated. Please transition to for product details. Learn more

Note: This documentation provides load mode-specific API payloads for this transportation type. For a comprehensive reference of all available API parameters that can be applied to these payloads, including parameters across all load modes, please refer to the Create Shipment / Update Shipment documentation.

This API is called after the carrier has accepted the tender for the load. FourKites does not limit customers from creating more than one load with the same load number or PRO number -- creation of more than one load with the same load or PRO number will cause duplication of loads, which will end up affecting the tracking performance. Customers are advised to handle this on their side. To learn more about Idempotency Protection, refer here.

If you receive a server error (5xx error code), please try again a few times. It's best to wait a little longer between each retry attempt. Try at least 3-5 times before giving up, as many server issues resolve themselves quickly.

Supporting Document: Create Shipment

Rate Limit

1 request per second

Format Supported

JSON

Authenticated Resource

API Key

For more information on Authentication, click here.

Production

POST

https://api.fourkites.com/api/v1/tracking

import http.client
import json

conn = http.client.HTTPSConnection("api.fourkites.com")
payload = json.dumps({
  "trackingInfo": {
    "mawb": "70038067644"
  },
  "trackingNumber": "70038067644",
  "load": {
    "loadNumber": "TEST_LOAD_02",
    "carrier": "1234",
    "priority": "high",
    "carrierPermalink": "bbb-ccc-aaa-123",
    "stops": [
      {
        "stopType": "pickup",
        "city": "Chennai",
        "state": "TN",
        "country": "IN",
        "postalCode": None,
        "latitude": "45.898869934",
        "longitude": "-122.79996",
        "geofencePoints": [],
        "wantTime": None,
        "earliestWantTime": None,
        "latestWantTime": None,
        "transportationMode": None,
        "addressType": ""
      },
      {
        "stopType": "originAirport",
        "airTotalPieces": "100",
        "externalAddressId": "MAA",
        "sequence": "1",
        "departingFlightNumber": "GTI8030",
        "earliestAppointmentTime": "2024-03-11T04:25:45.000Z",
        "latestAppointmentTime": "2024-03-11T06:25:45.000Z"
      },
      {
        "stopType": "destinationAirport",
        "externalAddressId": "ANC",
        "sequence": "2",
        "earliestAppointmentTime": "2024-04-15T04:25:45.000Z",
        "latestAppointmentTime": "2024-04-16T06:25:45.000Z"
      }
    ]
  }
})
headers = {
  'Content-Type': 'application/json',
  'apikey': 'REPLACE_KEY_VALUE'
}
conn.request("POST", "/api/v1/tracking", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Staging

POST

https://api-staging.fourkites.com/api/v1/tracking

import http.client
import json

conn = http.client.HTTPSConnection("api-staging.fourkites.com")
payload = json.dumps({
  "trackingInfo": {
    "mawb": "70038067644"
  },
  "trackingNumber": "70038067644",
  "load": {
    "loadNumber": "TEST_LOAD_02",
    "carrier": "1234",
    "priority": "high",
    "carrierPermalink": "bbb-ccc-aaa-123",
    "stops": [
      {
        "stopType": "pickup",
        "city": "Chennai",
        "state": "TN",
        "country": "IN",
        "postalCode": None,
        "latitude": "45.898869934",
        "longitude": "-122.79996",
        "geofencePoints": [],
        "wantTime": None,
        "earliestWantTime": None,
        "latestWantTime": None,
        "transportationMode": None,
        "addressType": ""
      },
      {
        "stopType": "originAirport",
        "airTotalPieces": "100",
        "externalAddressId": "MAA",
        "sequence": "1",
        "departingFlightNumber": "GTI8030",
        "earliestAppointmentTime": "2024-03-11T04:25:45.000Z",
        "latestAppointmentTime": "2024-03-11T06:25:45.000Z"
      },
      {
        "stopType": "destinationAirport",
        "externalAddressId": "ANC",
        "sequence": "2",
        "earliestAppointmentTime": "2024-04-15T04:25:45.000Z",
        "latestAppointmentTime": "2024-04-16T06:25:45.000Z"
      }
    ]
  }
})
headers = {
  'Content-Type': 'application/json',
  'apikey': 'REPLACE_KEY_VALUE'
}
conn.request("POST", "/api/v1/tracking", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Azure - Production

POST

https://api.ng.fourkites.com/api/v1/tracking

import http.client
import json

conn = http.client.HTTPSConnection("api.ng.fourkites.com")
payload = json.dumps({
  "trackingInfo": {
    "mawb": "70038067644"
  },
  "trackingNumber": "70038067644",
  "load": {
    "loadNumber": "TEST_LOAD_02",
    "carrier": "1234",
    "priority": "high",
    "carrierPermalink": "bbb-ccc-aaa-123",
    "stops": [
      {
        "stopType": "pickup",
        "city": "Chennai",
        "state": "TN",
        "country": "IN",
        "postalCode": None,
        "latitude": "45.898869934",
        "longitude": "-122.79996",
        "geofencePoints": [],
        "wantTime": None,
        "earliestWantTime": None,
        "latestWantTime": None,
        "transportationMode": None,
        "addressType": ""
      },
      {
        "stopType": "originAirport",
        "airTotalPieces": "100",
        "externalAddressId": "MAA",
        "sequence": "1",
        "departingFlightNumber": "GTI8030",
        "earliestAppointmentTime": "2024-03-11T04:25:45.000Z",
        "latestAppointmentTime": "2024-03-11T06:25:45.000Z"
      },
      {
        "stopType": "destinationAirport",
        "externalAddressId": "ANC",
        "sequence": "2",
        "earliestAppointmentTime": "2024-04-15T04:25:45.000Z",
        "latestAppointmentTime": "2024-04-16T06:25:45.000Z"
      }
    ]
  }
})
headers = {
  'Content-Type': 'application/json',
  'apikey': 'REPLACE_KEY_VALUE'
}
conn.request("POST", "/api/v1/tracking", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Azure - Staging

POST

https://api-staging.ng.fourkites.com/api/v1/tracking

var settings = {
  "url": "https://api-staging.ng.fourkites.com/api/v1/tracking",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "apikey": "REPLACE_KEY_VALUE"
  },
  "data": JSON.stringify({
    "trackingInfo": {
      "mawb": "70038067644"
    },
    "trackingNumber": "70038067644",
    "load": {
      "loadNumber": "TEST_LOAD_02",
      "carrier": "1234",
      "priority": "high",
      "carrierPermalink": "bbb-ccc-aaa-123",
      "stops": [
        {
          "stopType": "pickup",
          "city": "Chennai",
          "state": "TN",
          "country": "IN",
          "postalCode": null,
          "latitude": "45.898869934",
          "longitude": "-122.79996",
          "geofencePoints": [],
          "wantTime": null,
          "earliestWantTime": null,
          "latestWantTime": null,
          "transportationMode": null,
          "addressType": ""
        },
        {
          "stopType": "originAirport",
          "airTotalPieces": "100",
          "externalAddressId": "MAA",
          "sequence": "1",
          "departingFlightNumber": "GTI8030",
          "earliestAppointmentTime": "2024-03-11T04:25:45.000Z",
          "latestAppointmentTime": "2024-03-11T06:25:45.000Z"
        },
        {
          "stopType": "destinationAirport",
          "externalAddressId": "ANC",
          "sequence": "2",
          "earliestAppointmentTime": "2024-04-15T04:25:45.000Z",
          "latestAppointmentTime": "2024-04-16T06:25:45.000Z"
        }
      ]
    }
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});