Version 4.0.0 of project44's API. If you're not familiar with project44, we recommend checking out our guides first: https://developers.project44.com/guides/shippers and https://developers.project44.com/guides/carriers.
API used for registering and managing OAuth 2.0 client applications. See the "Authentication" section above for more information. To authorize API requests to project44 for an API integration, first your client application must be registered with project44, which will issue your application a client id and secret. These credentials can then be used to generate bearer tokens, which can be included on all other API requests to authorize your client application. The client application is authorized through the project44 user management UI as a machine user with username "app-{client_id}@client-applications.project44.com".
An admin user (with Movement user role "Customer Admin") must use HTTP Basic Authentication with this API to manage client applications. Basic Authentication is deprecated for all other APIs, besides token generation, in favor of passing the access token generated via OAuth 2.0.
API for OAuth 2.0 token generation. See the "Authentication" section above for more information. Once your client application is registered, you can use the token generation endpoint to authenticate with your application's client id and secret in exchange for a bearer token to be included on all other API requests to authenticate as that client application. The client application is authorized through the project44 user management UI as a machine user with username "app-{client_id}@client-applications.project44.com".
To generate an access token, you may authenticate your client application by providing its client id and secret either in the body of the request or in the form of HTTP Basic Authentication (but you may not use both ways in the same request).
List of accessorial services to be requested for this shipment. Some capacity providers support accessorial services without providing a way of requesting them through their API. To handle this, project44 sends these accessorial services through the capacity provider's pickup note API field, according to the shipment note configuration.
The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
SCAC of the carrier that is to pick up this shipment. Required only for capacity providers that support multiple SCACs.
The quote number for this shipment assigned by the capacity provider. Only a few LTL capacity providers accept a quote number when placing a shipment for pickup. Most volume LTL capacity providers, however, require a quote number.
A date and time range, local to the applicable location, representing a window of availability.
Note that applies to the delivery of this shipment. Currently, since nearly all capacity provider APIs have only a pickup note field and not a delivery note field, this delivery note will be inserted into the capacity provider's pickup note API field, according to the shipment note configuration.
A list of parties and their identifiers related to the destination location. These are typically your customers receiving freight at the destination.
An override of direction for the capacity provider account used by this request, if it has 'Enable API override of direction' set as 'true' in the project44 Self-Service Portal.This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.
A more granular representation of a line item. Required if no lineItems. Allows for order level tracking, more accurate rates, and more detailed BOLs. Currently not supported by all vendors. An enhancedHandlingUnit consists of one or more handling units, e.g. a pallet or a drum, one or more packages (the container on the handling unit e.g. a box), and package contents. NMFC codes and freight classes can be assigned at the handling unit and package level, while package contents can be associated with a DELIVERY_NUMBER, SKU_NUMBER, or PURCHASE_ORDER_NUMBER. Passing in both this field and lineItems is accepted, but at least one is required.
A list of the quantity of certain handling unit types. If there are multiple types of handling units e.g. pallet, drum, box, the quantity of each handling unit type should be specified.
The line items to be shipped.A line item consists of one or more packages, all of the same package type and with the same dimensions, freight class, and NMFC code. Each package, however, may have a different number of pieces and a different weight. Note that each capacity provider has a different maximum number of line items that they can accept. NOTE: This field is similar to, but not the same as, the enhancedHandlingUnits field. The enhancedHandlingUnits fields can contain more detailed information for use by both the carrier and the shipper.
A list of parties and their identifiers related to the origin location. These are typically your suppliers providing freight at the origin.
A date and time range, local to the applicable location, representing a window of availability.
Note that applies to the pickup of this shipment. The shipment note configuration determines the final pickup note that is sent through the capacity provider's API and whether or not part of it may be cut off.
An override of payment terms for the capacity provider account used by this request, if it has 'Enable API override of payment terms' set as 'true' in the project44 Self-Service Portal. This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.
A list of identifiers or reference numbers for this shipment. Most capacity providers accept only identifiers of types 'BILL_OF_LADING', 'PURCHASE_ORDER', and 'CUSTOMER_REFERENCE'. Only one identifier of each type may be provided. An identifier of type 'SYSTEM_GENERATED' may not be provided. An identifier of type 'EXTERNAL' may be provided and subsequently tracked with through project44 -- this identifier will not be communicated to the capacity provider.
The total linear feet that the shipment being quoted will take up in a trailer. Only for volume LTL shipments.
Total numbers of packaged units that are expected to be shipped. This should match the number of units a driver should be loading onto the truck.
curl -i -X POST \ 'https://na12.api.project44.com/api/v2/shipments?accountNonExpired=true&accountNonLocked=true&credentialsNonExpired=true&enabled=true&id=0&locale=string®istrationDate=2019-08-24T14%3A15%3A22Z&tenantId=0&tenantPurpose=DEFAULT&tenantUuid=e46705ba-31a8-4f12-b6d3-f41ec1d77a9a&username=string' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "accessorialServices": [ { "code": "string" } ], "apiConfiguration": { "allowUnsupportedAccessorials": true, "enableUnitConversion": true, "fallBackToDefaultAccountGroup": true, "noteConfiguration": { "enableTruncation": true, "noteSections": [ { "name": "PICKUP_NOTE" } ] }, "preScheduledPickup": true, "pickupOnly": true }, "capacityProviderAccountGroup": { "accounts": [ { "code": "string" } ], "code": "string" }, "carrierCode": "string", "capacityProviderQuoteNumber": "string", "customsInfo": { "customsBrokerLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } } }, "currencyCode": "USD", "destinationLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } }, "deliveryWindow": { "date": "2019-08-24", "endTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 }, "startTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 } }, "deliveryNote": "string", "destinationInvolvedParties": [ { "addressInfo": { "addressLines": [ "string" ], "addressLabel": "string", "city": "string", "country": "US", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "postalCode": "string", "state": "string" }, "contactInfo": { "companyName": "string", "email": "user@example.com", "familyName": "string", "givenName": "string", "mobilePhoneNumber": "string", "phoneNumber": "string" }, "identifyingCodes": { "codeListProvider": "WAVE", "codeListName": "DID", "partyCode": "string" }, "locationIdentifiers": [ { "type": "EXTERNAL", "value": "string" } ], "partyType": "SHIPPER", "vatNumber": "string" } ], "directionOverride": "SHIPPER", "enhancedHandlingUnits": [ { "commodityType": "string", "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" }, "deliveryStopNumber": 0, "description": "string", "freightClasses": [ "string" ], "handlingUnitType": "BAG", "harmonizedCode": "string", "handlingUnitQuantity": 0, "handlingUnitDimensions": { "height": 0, "length": 0, "width": 0 }, "nmfcCodes": [ { "code": "string" } ], "pickupStopNumber": 0, "packages": [ { "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" }, "description": "string", "freightClass": "string", "involvedParties": [ { "addressInfo": { "addressLines": [] }, "contactInfo": {}, "identifyingCodes": {}, "locationIdentifiers": [ null ], "partyType": "SHIPPER", "vatNumber": "string" } ], "nmfcCodes": [ { "code": "string" } ], "packageQuantity": 0, "packageContainerType": "BAG", "packageDimensions": { "height": 0, "length": 0, "width": 0 }, "packageContents": [ { "countryOfManufacture": "US", "description": "string", "hazmatDetails": [ null ], "packageContentQuantity": 0, "packageContentIdentifiers": [ null ] } ], "weightPerPackage": 0 } ], "stackable": true, "totalValue": { "amount": 0, "currency": "USD" }, "weightPerHandlingUnit": 0 } ], "emergencyContact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" }, "handlingUnitTypeQuantities": [ { "handlingUnitType": "BAG", "quantity": 0 } ], "lineItems": [ { "commodityType": "string", "countryOfManufacture": "US", "description": "string", "freightClass": "50,55,60,65,70,77.5,85,92.5,100,110,125,150,175,200,250,300,400,500", "hazmatDetail": { "hazardClass": "string", "identificationNumber": "string", "properShippingName": "string", "packingGroup": "I" }, "harmonizedCode": "string", "id": 0, "insuranceAmount": 0, "nmfcItemCode": "string", "nmfcSubCode": "string", "packageDimensions": { "height": 0, "length": 0, "width": 0 }, "packageType": "BAG", "stackable": true, "totalWeight": 1, "totalPackages": 1, "totalPieces": 1, "totalValue": 0 } ], "lengthUnit": "IN", "originLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } }, "originInvolvedParties": [ { "addressInfo": { "addressLines": [ "string" ], "addressLabel": "string", "city": "string", "country": "US", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "postalCode": "string", "state": "string" }, "contactInfo": { "companyName": "string", "email": "user@example.com", "familyName": "string", "givenName": "string", "mobilePhoneNumber": "string", "phoneNumber": "string" }, "identifyingCodes": { "codeListProvider": "WAVE", "codeListName": "DID", "partyCode": "string" }, "locationIdentifiers": [ { "type": "EXTERNAL", "value": "string" } ], "partyType": "SHIPPER", "vatNumber": "string" } ], "pickupWindow": { "date": "2019-08-24", "endTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 }, "startTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 } }, "pickupNote": "string", "paymentTermsOverride": "PREPAID", "requesterLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } }, "rateQuoteId": "string", "shipmentIdentifiers": [ { "type": "BILL_OF_LADING", "value": "string" } ], "totalLinearFeet": 0, "totalHandlingUnits": 1, "weightUnit": "LB" }'
Created
URL pointing to a PDF document of the capacity provider's Bill of Lading, if available.
The project44-generated id of this LTL shipment. This can be passed to LTL tracking to retrieve this shipment's status information.
System messages and messages from the capacity provider with severity 'INFO' or 'WARNING'. No messages with severity 'ERROR' will be returned here.
Customers who have enabled our Volume Visualizer product will find a URL to a PDF document illustrating the optimized item arrangement, for the shipment's total linear footage value. (Example: https://na12.api.project44.com/unauthenticated/linear-feet/pdf/{linearFeetVisualizationId})
The final note that was sent through the capacity provider's pickup note API field, as constructed by project44 according to the requested shipment note configuration.
The pickup date and time as provided by the capacity provider in the timezone of origin location of the shipment. (format: yyyy-MM-dd'T'HH:mm:ss)
A list of identifiers for the confirmed shipment. Nearly all capacity providers provide a pickup confirmation number, which will appear in this list with type 'PICKUP'. A few capacity providers also provide a PRO number when a shipment is confirmed. Shipment identifiers provided by the customer will show up here, as well.
{ "capacityProviderBolUrl": "string", "id": 0, "infoMessages": [ { … } ], "packingVisualizationUrl": "string", "pickupNote": "string", "pickupDateTime": "2019-08-24T14:15:22Z", "shipmentIdentifiers": [ { … } ] }
List of accessorial services to be requested for this shipment. Some capacity providers support accessorial services without providing a way of requesting them through their API. To handle this, project44 sends these accessorial services through the capacity provider's pickup note API field, according to the shipment note configuration.
The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
SCAC of the carrier that is to pick up this shipment. Required only for capacity providers that support multiple SCACs.
The quote number for this shipment assigned by the capacity provider. Only a few LTL capacity providers accept a quote number when placing a shipment for pickup. Most volume LTL capacity providers, however, require a quote number.
A date and time range, local to the applicable location, representing a window of availability.
Note that applies to the delivery of this shipment. Currently, since nearly all capacity provider APIs have only a pickup note field and not a delivery note field, this delivery note will be inserted into the capacity provider's pickup note API field, according to the shipment note configuration.
A list of parties and their identifiers related to the destination location. These are typically your customers receiving freight at the destination.
An override of direction for the capacity provider account used by this request, if it has 'Enable API override of direction' set as 'true' in the project44 Self-Service Portal.This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.
A more granular representation of a line item. Required if no lineItems. Allows for order level tracking, more accurate rates, and more detailed BOLs. Currently not supported by all vendors. An enhancedHandlingUnit consists of one or more handling units, e.g. a pallet or a drum, one or more packages (the container on the handling unit e.g. a box), and package contents. NMFC codes and freight classes can be assigned at the handling unit and package level, while package contents can be associated with a DELIVERY_NUMBER, SKU_NUMBER, or PURCHASE_ORDER_NUMBER. Passing in both this field and lineItems is accepted, but at least one is required.
A list of the quantity of certain handling unit types. If there are multiple types of handling units e.g. pallet, drum, box, the quantity of each handling unit type should be specified.
The line items to be shipped.A line item consists of one or more packages, all of the same package type and with the same dimensions, freight class, and NMFC code. Each package, however, may have a different number of pieces and a different weight. Note that each capacity provider has a different maximum number of line items that they can accept. NOTE: This field is similar to, but not the same as, the enhancedHandlingUnits field. The enhancedHandlingUnits fields can contain more detailed information for use by both the carrier and the shipper.
A list of parties and their identifiers related to the origin location. These are typically your suppliers providing freight at the origin.
A date and time range, local to the applicable location, representing a window of availability.
Note that applies to the pickup of this shipment. The shipment note configuration determines the final pickup note that is sent through the capacity provider's API and whether or not part of it may be cut off.
An override of payment terms for the capacity provider account used by this request, if it has 'Enable API override of payment terms' set as 'true' in the project44 Self-Service Portal. This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.
A list of identifiers or reference numbers for this shipment. Most capacity providers accept only identifiers of types 'BILL_OF_LADING', 'PURCHASE_ORDER', and 'CUSTOMER_REFERENCE'. Only one identifier of each type may be provided. An identifier of type 'SYSTEM_GENERATED' may not be provided. An identifier of type 'EXTERNAL' may be provided and subsequently tracked with through project44 -- this identifier will not be communicated to the capacity provider.
The total linear feet that the shipment being quoted will take up in a trailer. Only for volume LTL shipments.
Total numbers of packaged units that are expected to be shipped. This should match the number of units a driver should be loading onto the truck.
curl -i -X POST \ 'https://na12.api.project44.com/api/v3/shipments?accountNonExpired=true&accountNonLocked=true&credentialsNonExpired=true&enabled=true&id=0&locale=string®istrationDate=2019-08-24T14%3A15%3A22Z&tenantId=0&tenantPurpose=DEFAULT&tenantUuid=e46705ba-31a8-4f12-b6d3-f41ec1d77a9a&username=string' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "accessorialServices": [ { "code": "string" } ], "apiConfiguration": { "allowUnsupportedAccessorials": true, "enableUnitConversion": true, "fallBackToDefaultAccountGroup": true, "noteConfiguration": { "enableTruncation": true, "noteSections": [ { "name": "PICKUP_NOTE" } ] }, "preScheduledPickup": true, "pickupOnly": true }, "capacityProviderAccountGroup": { "accounts": [ { "code": "string" } ], "code": "string" }, "carrierCode": "string", "capacityProviderQuoteNumber": "string", "customsInfo": { "customsBrokerLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } } }, "currencyCode": "USD", "destinationLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } }, "deliveryWindow": { "date": "2019-08-24", "endTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 }, "startTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 } }, "deliveryNote": "string", "destinationInvolvedParties": [ { "addressInfo": { "addressLines": [ "string" ], "addressLabel": "string", "city": "string", "country": "US", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "postalCode": "string", "state": "string" }, "contactInfo": { "companyName": "string", "email": "user@example.com", "familyName": "string", "givenName": "string", "mobilePhoneNumber": "string", "phoneNumber": "string" }, "identifyingCodes": { "codeListProvider": "WAVE", "codeListName": "DID", "partyCode": "string" }, "locationIdentifiers": [ { "type": "EXTERNAL", "value": "string" } ], "partyType": "SHIPPER", "vatNumber": "string" } ], "directionOverride": "SHIPPER", "enhancedHandlingUnits": [ { "commodityType": "string", "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" }, "deliveryStopNumber": 0, "description": "string", "freightClasses": [ "string" ], "handlingUnitType": "BAG", "harmonizedCode": "string", "handlingUnitQuantity": 0, "handlingUnitDimensions": { "height": 0, "length": 0, "width": 0 }, "nmfcCodes": [ { "code": "string" } ], "pickupStopNumber": 0, "packages": [ { "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" }, "description": "string", "freightClass": "string", "involvedParties": [ { "addressInfo": { "addressLines": [] }, "contactInfo": {}, "identifyingCodes": {}, "locationIdentifiers": [ null ], "partyType": "SHIPPER", "vatNumber": "string" } ], "nmfcCodes": [ { "code": "string" } ], "packageQuantity": 0, "packageContainerType": "BAG", "packageDimensions": { "height": 0, "length": 0, "width": 0 }, "packageContents": [ { "countryOfManufacture": "US", "description": "string", "hazmatDetails": [ null ], "packageContentQuantity": 0, "packageContentIdentifiers": [ null ] } ], "weightPerPackage": 0 } ], "stackable": true, "totalValue": { "amount": 0, "currency": "USD" }, "weightPerHandlingUnit": 0 } ], "emergencyContact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" }, "handlingUnitTypeQuantities": [ { "handlingUnitType": "BAG", "quantity": 0 } ], "lineItems": [ { "commodityType": "string", "countryOfManufacture": "US", "description": "string", "freightClass": "50,55,60,65,70,77.5,85,92.5,100,110,125,150,175,200,250,300,400,500", "hazmatDetail": { "hazardClass": "string", "identificationNumber": "string", "properShippingName": "string", "packingGroup": "I" }, "harmonizedCode": "string", "id": 0, "insuranceAmount": 0, "nmfcItemCode": "string", "nmfcSubCode": "string", "packageDimensions": { "height": 0, "length": 0, "width": 0 }, "packageType": "BAG", "stackable": true, "totalWeight": 1, "totalPackages": 1, "totalPieces": 1, "totalValue": 0 } ], "lengthUnit": "IN", "originLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } }, "originInvolvedParties": [ { "addressInfo": { "addressLines": [ "string" ], "addressLabel": "string", "city": "string", "country": "US", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "postalCode": "string", "state": "string" }, "contactInfo": { "companyName": "string", "email": "user@example.com", "familyName": "string", "givenName": "string", "mobilePhoneNumber": "string", "phoneNumber": "string" }, "identifyingCodes": { "codeListProvider": "WAVE", "codeListName": "DID", "partyCode": "string" }, "locationIdentifiers": [ { "type": "EXTERNAL", "value": "string" } ], "partyType": "SHIPPER", "vatNumber": "string" } ], "pickupWindow": { "date": "2019-08-24", "endTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 }, "startTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 } }, "pickupNote": "string", "paymentTermsOverride": "PREPAID", "requesterLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } }, "rateQuoteId": "string", "shipmentIdentifiers": [ { "type": "BILL_OF_LADING", "value": "string" } ], "totalLinearFeet": 0, "totalHandlingUnits": 1, "weightUnit": "LB" }'
Created
URL pointing to a PDF document of the capacity provider's Bill of Lading, if available.
The project44-generated id of this LTL shipment. This can be passed to LTL tracking to retrieve this shipment's status information.
System messages and messages from the capacity provider with severity 'INFO' or 'WARNING'. No messages with severity 'ERROR' will be returned here.
Customers who have enabled our Volume Visualizer product will find a URL to a PDF document illustrating the optimized item arrangement, for the shipment's total linear footage value. (Example: https://na12.api.project44.com/unauthenticated/linear-feet/pdf/{linearFeetVisualizationId})
The final note that was sent through the capacity provider's pickup note API field, as constructed by project44 according to the requested shipment note configuration.
The pickup date and time as provided by the capacity provider in the timezone of origin location of the shipment. (format: yyyy-MM-dd'T'HH:mm:ss)
A list of identifiers for the confirmed shipment. Nearly all capacity providers provide a pickup confirmation number, which will appear in this list with type 'PICKUP'. A few capacity providers also provide a PRO number when a shipment is confirmed. Shipment identifiers provided by the customer will show up here, as well.
{ "capacityProviderBolUrl": "string", "id": 0, "infoMessages": [ { … } ], "packingVisualizationUrl": "string", "pickupNote": "string", "pickupDateTime": "2019-08-24T14:15:22Z", "shipmentIdentifiers": [ { … } ] }
Contains fields used to configure the LTL shipment API.
The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
curl -i -X POST \ 'https://na12.api.project44.com/api/v3/shipments/cancellations?accountNonExpired=true&accountNonLocked=true&credentialsNonExpired=true&enabled=true&id=0&locale=string®istrationDate=2019-08-24T14%3A15%3A22Z&tenantId=0&tenantPurpose=DEFAULT&tenantUuid=e46705ba-31a8-4f12-b6d3-f41ec1d77a9a&username=string' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "apiConfiguration": { "fallBackToDefaultAccountGroup": true }, "capacityProviderAccountGroup": { "accounts": [ { "code": "string" } ], "code": "string" }, "originAddress": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "shipmentIdentifiers": [ { "primaryForType": true, "source": "CUSTOMER", "type": "PRO", "value": "string" } ] }'
{ "infoMessages": [ { … } ], "shipmentIdentifiers": [ { … } ] }
curl -i -X GET \ https://na12.api.project44.com/api/v3/shipments/pronumbers/query \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
[ { "blockStart": 0, "blockEnd": 0, "currentProNumber": 0, "remainingProsInBlock": 0, "vendorId": "string" } ]
curl -i -X PUT \ https://na12.api.project44.com/api/v3/shipments/pronumbers/query \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "blockStart": 0, "blockEnd": 0, "checkDigit": 0, "vendorId": "string" }'
The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
curl -i -X POST \ 'https://na12.api.project44.com/api/v3/shipments/pronumbers/query?accountNonExpired=true&accountNonLocked=true&credentialsNonExpired=true&enabled=true&id=0&locale=string®istrationDate=2019-08-24T14%3A15%3A22Z&tenantId=0&tenantPurpose=DEFAULT&tenantUuid=e46705ba-31a8-4f12-b6d3-f41ec1d77a9a&username=string' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "apiConfiguration": { "fallBackToDefaultAccountGroup": true }, "capacityProviderAccountGroup": { "accounts": [ { "code": "string" } ], "code": "string" }, "originLocation": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" } }'
{ "proNumber": "string", "vendorId": "string" }
List of accessorial services to be requested for this shipment. Some capacity providers support accessorial services without providing a way of requesting them through their API. To handle this, project44 sends these accessorial services through the capacity provider's pickup note API field, according to the shipment note configuration.
The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
SCAC of the carrier that is to pick up this shipment. Required only for capacity providers that support multiple SCACs.
The quote number for this shipment assigned by the capacity provider. Only a few LTL capacity providers accept a quote number when placing a shipment for pickup. Most volume LTL capacity providers, however, require a quote number.
A date and time range, local to the applicable location, representing a window of availability.
Note that applies to the delivery of this shipment. Currently, since nearly all capacity provider APIs have only a pickup note field and not a delivery note field, this delivery note will be inserted into the capacity provider's pickup note API field, according to the shipment note configuration.
A list of parties and their identifiers related to the destination location. These are typically your customers receiving freight at the destination.
An override of direction for the capacity provider account used by this request, if it has 'Enable API override of direction' set as 'true' in the project44 Self-Service Portal.This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.
A more granular representation of a line item. Required if no lineItems. Allows for order level tracking, more accurate rates, and more detailed BOLs. Currently not supported by all vendors. An enhancedHandlingUnit consists of one or more handling units, e.g. a pallet or a drum, one or more packages (the container on the handling unit e.g. a box), and package contents. NMFC codes and freight classes can be assigned at the handling unit and package level, while package contents can be associated with a DELIVERY_NUMBER, SKU_NUMBER, or PURCHASE_ORDER_NUMBER. Passing in both this field and lineItems is accepted, but at least one is required.
A list of the quantity of certain handling unit types. If there are multiple types of handling units e.g. pallet, drum, box, the quantity of each handling unit type should be specified.
The line items to be shipped.A line item consists of one or more packages, all of the same package type and with the same dimensions, freight class, and NMFC code. Each package, however, may have a different number of pieces and a different weight. Note that each capacity provider has a different maximum number of line items that they can accept. NOTE: This field is similar to, but not the same as, the enhancedHandlingUnits field. The enhancedHandlingUnits fields can contain more detailed information for use by both the carrier and the shipper.
A list of parties and their identifiers related to the origin location. These are typically your suppliers providing freight at the origin.
A date and time range, local to the applicable location, representing a window of availability.
Note that applies to the pickup of this shipment. The shipment note configuration determines the final pickup note that is sent through the capacity provider's API and whether or not part of it may be cut off.
An override of payment terms for the capacity provider account used by this request, if it has 'Enable API override of payment terms' set as 'true' in the project44 Self-Service Portal. This functionality is typically used in situations where both inbound and outbound shipments are common for a given capacity provider and account number.
A list of identifiers or reference numbers for this shipment. Most capacity providers accept only identifiers of types 'BILL_OF_LADING', 'PURCHASE_ORDER', and 'CUSTOMER_REFERENCE'. Only one identifier of each type may be provided. An identifier of type 'SYSTEM_GENERATED' may not be provided. An identifier of type 'EXTERNAL' may be provided and subsequently tracked with through project44 -- this identifier will not be communicated to the capacity provider.
The total linear feet that the shipment being quoted will take up in a trailer. Only for volume LTL shipments.
Total numbers of packaged units that are expected to be shipped. This should match the number of units a driver should be loading onto the truck.
curl -i -X POST \ 'https://na12.api.project44.com/api/v4/ltl/dispatchedshipments?accountNonExpired=true&accountNonLocked=true&credentialsNonExpired=true&enabled=true&id=0&locale=string®istrationDate=2019-08-24T14%3A15%3A22Z&tenantId=0&tenantPurpose=DEFAULT&tenantUuid=e46705ba-31a8-4f12-b6d3-f41ec1d77a9a&username=string' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "accessorialServices": [ { "code": "string" } ], "apiConfiguration": { "allowUnsupportedAccessorials": true, "enableUnitConversion": true, "fallBackToDefaultAccountGroup": true, "noteConfiguration": { "enableTruncation": true, "noteSections": [ { "name": "PICKUP_NOTE" } ] }, "preScheduledPickup": true, "pickupOnly": true }, "capacityProviderAccountGroup": { "accounts": [ { "code": "string" } ], "code": "string" }, "carrierCode": "string", "capacityProviderQuoteNumber": "string", "customsInfo": { "customsBrokerLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } } }, "currencyCode": "USD", "destinationLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } }, "deliveryWindow": { "date": "2019-08-24", "endTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 }, "startTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 } }, "deliveryNote": "string", "destinationInvolvedParties": [ { "addressInfo": { "addressLines": [ "string" ], "addressLabel": "string", "city": "string", "country": "US", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "postalCode": "string", "state": "string" }, "contactInfo": { "companyName": "string", "email": "user@example.com", "familyName": "string", "givenName": "string", "mobilePhoneNumber": "string", "phoneNumber": "string" }, "identifyingCodes": { "codeListProvider": "WAVE", "codeListName": "DID", "partyCode": "string" }, "locationIdentifiers": [ { "type": "EXTERNAL", "value": "string" } ], "partyType": "SHIPPER", "vatNumber": "string" } ], "directionOverride": "SHIPPER", "enhancedHandlingUnits": [ { "commodityType": "string", "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" }, "deliveryStopNumber": 0, "description": "string", "freightClasses": [ "string" ], "handlingUnitType": "BAG", "harmonizedCode": "string", "handlingUnitQuantity": 0, "handlingUnitDimensions": { "height": 0, "length": 0, "width": 0 }, "nmfcCodes": [ { "code": "string" } ], "pickupStopNumber": 0, "packages": [ { "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" }, "description": "string", "freightClass": "string", "involvedParties": [ { "addressInfo": { "addressLines": [] }, "contactInfo": {}, "identifyingCodes": {}, "locationIdentifiers": [ null ], "partyType": "SHIPPER", "vatNumber": "string" } ], "nmfcCodes": [ { "code": "string" } ], "packageQuantity": 0, "packageContainerType": "BAG", "packageDimensions": { "height": 0, "length": 0, "width": 0 }, "packageContents": [ { "countryOfManufacture": "US", "description": "string", "hazmatDetails": [ null ], "packageContentQuantity": 0, "packageContentIdentifiers": [ null ] } ], "weightPerPackage": 0 } ], "stackable": true, "totalValue": { "amount": 0, "currency": "USD" }, "weightPerHandlingUnit": 0 } ], "emergencyContact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" }, "handlingUnitTypeQuantities": [ { "handlingUnitType": "BAG", "quantity": 0 } ], "lineItems": [ { "commodityType": "string", "countryOfManufacture": "US", "description": "string", "freightClass": "50,55,60,65,70,77.5,85,92.5,100,110,125,150,175,200,250,300,400,500", "hazmatDetail": { "hazardClass": "string", "identificationNumber": "string", "properShippingName": "string", "packingGroup": "I" }, "harmonizedCode": "string", "id": 0, "insuranceAmount": 0, "nmfcItemCode": "string", "nmfcSubCode": "string", "packageDimensions": { "height": 0, "length": 0, "width": 0 }, "packageType": "BAG", "stackable": true, "totalWeight": 1, "totalPackages": 1, "totalPieces": 1, "totalValue": 0 } ], "lengthUnit": "IN", "originLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } }, "originInvolvedParties": [ { "addressInfo": { "addressLines": [ "string" ], "addressLabel": "string", "city": "string", "country": "US", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "postalCode": "string", "state": "string" }, "contactInfo": { "companyName": "string", "email": "user@example.com", "familyName": "string", "givenName": "string", "mobilePhoneNumber": "string", "phoneNumber": "string" }, "identifyingCodes": { "codeListProvider": "WAVE", "codeListName": "DID", "partyCode": "string" }, "locationIdentifiers": [ { "type": "EXTERNAL", "value": "string" } ], "partyType": "SHIPPER", "vatNumber": "string" } ], "pickupWindow": { "date": "2019-08-24", "endTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 }, "startTime": { "hour": 0, "minute": 0, "nano": 0, "second": 0 } }, "pickupNote": "string", "paymentTermsOverride": "PREPAID", "requesterLocation": { "address": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "contact": { "companyName": "string", "contactName": "string", "email": "string", "faxNumber": "string", "faxNumberCountryCode": "string", "phoneNumber": "string", "phoneNumberCountryCode": "string", "phoneNumber2": "string", "phoneNumber2CountryCode": "string" } }, "rateQuoteId": "string", "shipmentIdentifiers": [ { "primaryForType": true, "source": "CUSTOMER", "type": "PRO", "value": "string" } ], "totalLinearFeet": 0, "totalHandlingUnits": 1, "weightUnit": "LB" }'
Created
URL pointing to a PDF document of the capacity provider's Bill of Lading, if available.
System messages and messages from the capacity provider with severity 'INFO' or 'WARNING'. No messages with severity 'ERROR' will be returned here.
Customers who have enabled our Volume Visualizer product will find a URL to a PDF document illustrating the optimized item arrangement, for the shipment's total linear footage value. (Example: https://na12.api.project44.com/unauthenticated/linear-feet/pdf/{linearFeetVisualizationId})
The final note that was sent through the capacity provider's pickup note API field, as constructed by project44 according to the requested shipment note configuration.
The pickup date and time as provided by the capacity provider in the timezone of origin location of the shipment. (format: yyyy-MM-dd'T'HH:mm:ss)
A list of identifiers for the confirmed shipment. Nearly all capacity providers provide a pickup confirmation number, which will appear in this list with type 'PICKUP'. A few capacity providers also provide a PRO number when a shipment is confirmed. Shipment identifiers provided by the customer will show up here, as well.
{ "capacityProviderBolUrl": "string", "id": 0, "infoMessages": [ { … } ], "packingVisualizationUrl": "string", "pickupNote": "string", "pickupDateTime": "2019-08-24T14:15:22Z", "shipmentIdentifiers": [ { … } ] }
Contains fields used to configure the LTL shipment API.
The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
curl -i -X POST \ 'https://na12.api.project44.com/api/v4/ltl/shipments/{id}/cancellations?accountNonExpired=true&accountNonLocked=true&credentialsNonExpired=true&enabled=true&id=0&locale=string®istrationDate=2019-08-24T14%3A15%3A22Z&tenantId=0&tenantPurpose=DEFAULT&tenantUuid=e46705ba-31a8-4f12-b6d3-f41ec1d77a9a&username=string' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "apiConfiguration": { "fallBackToDefaultAccountGroup": true }, "capacityProviderAccountGroup": { "accounts": [ { "code": "string" } ], "code": "string" }, "originAddress": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "shipmentIdentifiers": [ { "primaryForType": true, "source": "CUSTOMER", "type": "PRO", "value": "string" } ] }'
{ "infoMessages": [ { … } ], "shipmentIdentifiers": [ { … } ] }
Contains fields used to configure the LTL shipment API.
The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
curl -i -X POST \ 'https://na12.api.project44.com/api/v4/ltl/shipments/cancellations?accountNonExpired=true&accountNonLocked=true&credentialsNonExpired=true&enabled=true&id=0&locale=string®istrationDate=2019-08-24T14%3A15%3A22Z&tenantId=0&tenantPurpose=DEFAULT&tenantUuid=e46705ba-31a8-4f12-b6d3-f41ec1d77a9a&username=string' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "apiConfiguration": { "fallBackToDefaultAccountGroup": true }, "capacityProviderAccountGroup": { "accounts": [ { "code": "string" } ], "code": "string" }, "originAddress": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" }, "shipmentIdentifiers": [ { "primaryForType": true, "source": "CUSTOMER", "type": "PRO", "value": "string" } ] }'
{ "infoMessages": [ { … } ], "shipmentIdentifiers": [ { … } ] }
curl -i -X GET \ https://na12.api.project44.com/api/v4/shipments/pronumbers/query \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
[ { "blockStart": 0, "blockEnd": 0, "currentProNumber": 0, "remainingProsInBlock": 0, "vendorId": "string" } ]
curl -i -X PUT \ https://na12.api.project44.com/api/v4/shipments/pronumbers/query \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "blockStart": 0, "blockEnd": 0, "checkDigit": 0, "vendorId": "string" }'
The requested capacity provider account group containing the account used for authentication with the capacity provider's API.
curl -i -X POST \ 'https://na12.api.project44.com/api/v4/shipments/pronumbers/query?accountNonExpired=true&accountNonLocked=true&credentialsNonExpired=true&enabled=true&id=0&locale=string®istrationDate=2019-08-24T14%3A15%3A22Z&tenantId=0&tenantPurpose=DEFAULT&tenantUuid=e46705ba-31a8-4f12-b6d3-f41ec1d77a9a&username=string' \ -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \ -H 'Content-Type: application/json' \ -d '{ "apiConfiguration": { "fallBackToDefaultAccountGroup": true }, "capacityProviderAccountGroup": { "accounts": [ { "code": "string" } ], "code": "string" }, "originLocation": { "addressLines": [ "string" ], "city": "string", "country": "US", "postalCode": "string", "state": "string" } }'
{ "proNumber": "string", "vendorId": "string" }