Unfortunately, this feature is not supported on mobile devices. For the best experience, please use a computer.

project44 REST API (4.0.0)

Version 4.0.0 of project44's API

Download OpenAPI description
Languages
Servers
Mock server
https://developers.project44.com/_mock/api-reference/api-docs/
API endpoint for project44 tenants created in NA region
https://na12.api.project44.com/
API endpoint for project44 tenants created in EU region
https://eu12.api.project44.com/
API endpoint for project44 tenants created in the Sandbox environment
https://na12.api.sandbox.p-44.com/

OAuth 2.0: Client Applications

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 VOC 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.

Operations

OAuth 2.0: Token Generation

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).

Operations

LTL: Quotes

Quote LTL rates and retrieve transit times.

Operations

VLTL: Quotes

API used for quoting volume LTL rates.

Operations

VLTL: Dispatch

API used for scheduling volume LTL shipments.

Operations

LTL: Dispatch

API used for scheduling LTL shipments.

Operations

LTL: Tracking

API used for the retrieval of shipment status.

Operations

LTL: Image Retrieval

Access shipment images.

Operations

TL: Tracking

project44's Truckload Tracking endpoints give you or your customers visibility into your truckload shipments, including such features as predictive ETAs and temperature tracking. Use these endpoints to initialize (POST), track (GET), update (PUT), cancel (POST) or delete(DELETE) truckload shipments. You can return shipment information by either unique system ID or by identifier.

Operations

TL: Available Vehicles

API used for fetching vehicles within a specific radius and time window. Can only be used if opted into a project44 Co-Op.

Operations

TL: Connected Capacity

API for finding new connected carrier partners in the project44 network based on tracking performance

Operations

Rail: Tracking

API used for accessing rail shipment tracking.

Operations

Capacity Provider Account Group Management

Manage capacity provider account groups. Groups are used to sort capacity provider accounts on a per customer or location basis.

For example, you can add multiple capacity providers to a group if they all share lanes to the same origin/destination location.

Another example, if certain customers receive different rates for a capacity provider, it may be reasonable to use separate groups for each customer's capacity provider accounts.

Use these APIs to create (POST), retrieve (GET) or delete (DELETE) capacity provider account groups.

Operations

Capacity Provider Account Management

Manage capacity provider accounts where a capacity provider is typically used to represent a carrier.

Capacity providers have capacity provider account definitions also known as capacity provider account types. Capacity provider accounts are arranged in sets where each set contains one or more accounts for the same capacity provider. Each capacity provider's service is compatible with one and only one of these capacity provider accounts. Because most capacity providers have only one capacity provider account definition, most sets will contain only one capacity provider account. For capacity providers with more then one account definition, the set of accounts may consist of one account per account definition.

For example, FedEx has a standard account to be used with LTL rating, LTL and Volume LTL dispatch, tracking, and imaging and a separate account for Volume LTL rating. A set of FedEx capacity provider accounts may have a single standard account, a single volume LTL rating account, or both. Providing the capacity provider account set code in the request resolves which capacity provider account to use.

Capacity provider specific credential information is available in the portal.

Use these APIs to create (POST), retrieve (GET), update (POST) or delete (DELETE) capacity provider accounts.

Operations

Capacity Provider Contact Management

Manage locations. Locations combine physical addresses with contact details and are used in configuring Capacity Provider Accounts and Stop Locations, for example to identify the Bill To party.

Use these APIs to create (POST), update (PUT) or retrieve (GET) locations.

These operations are also all available under the /locations endpoint for backward compatibility.

Operations

Order Visibility

API used for orders and inventory items

Operations

Shipment: Tracking

API used for Shipment Tracking.

Operations

Shipment: Loads

API used for tracking Loads.

Operations

Multi-Modal: Image Retrieval

Access shipment images.

Operations

Shipment Attributes

Create and fetch predefined custom attributes for shipments. You must be a organization admin to perform this operation.

Operations

Capacity Provider Metadata

Retrieve capacity provider information needed to set up capacity provider accounts.

Operations

LTL: Push Tracking

As a capacity provider, push project44 shipments and status updates.

Operations

LTL: Push Imaging

As a capacity provider, push project44 images related to shipments.

Operations

TL: Capacity Provider Push

As a capacity provider, push project44 shipment-related info and quotes.

Operations

Asset Tracking

Track the location of an enrolled asset.

Operations

Webhook

Register client webhooks.

Operations

Parcel: Tracking

Track parcel shipments. Before parcel shipments can be tracked, they must first be initialized with a shipment identifier. Shipments cannot be modified once initialized and tracking has begun. To stop tracking a shipment, delete it.

Use these APIs to initialize (POST), track (GET), or delete (DELETE) parcel shipments.

Operations

Parcel: Webhook

Receive updates for a tracked parcel by defining a parcel-tracking-webhook.

Operations

Carrier: Document

API for managing carrier documents.

Analytics: Port Intelligence

API for Port Intelligence.

Operations

Filter Suggestions

Operations

Multi-modal: Booking

API used for multi-modal Booking.

LTL: Electronic BOL

API used for creating Electronic BOL

Operations

Create Electronic Bol

Request

As a shipper, create an eBOL request to send to a Carrier.

Bodyapplication/json
bolobjectrequired

BOL object containing requested pickup date, function, test,requestor role and optional special instructions.

bol.​requestedPickupDatestring(date-time)required

The intended Ship Date.

bol.​functionstring

The intent for the submitted request.

Default "Create"
bol.​isTestboolean

Indicates whether or not the submitted request is intended to be a test or not.

Default false
bol.​requestorRolestringrequired

An enumeration.

Enum"Shipper""Consignee""Third Party"
bol.​specialInstructionsstring

Special delivery instructions that need to be followed for the shipment's delivery.

versionstringrequired

Indicates which minor version of the Digital LTL Council Bill of Lading spec you are consuming Valid values: 2.0.0, 2.0.1, 2.1.0

imagesobject

Indicate if you want ebol or shipping labels returned in the response

notificationsArray of objects(Notification)

Include if you want notifications of shipment movements by text message or email.

referenceNumbersobjectrequired

Reference numbers related to the shipment such as Pro, QuoteId, MasterBol etc.

referenceNumbers.​prostring

Shipper's pre-assigned PRO number for the requested carrier. If not provided, one will be auto assigned by the carrier.

referenceNumbers.​quoteIdstring

Quote (estimate) number provided by the carrier after submitting a rate quote request.

referenceNumbers.​shipmentIdstring

Shipment Id (SID) number for the shipment.

referenceNumbers.​masterBolstring

Master Bill of Lading number for the shipment.

referenceNumbers.​bolArray of strings

A list of Bill of Lading identifiers.

referenceNumbers.​poArray of objects(Po)

A list of purchase orders.

referenceNumbers.​additionalReferencesArray of objects(AdditionalReference)required

A list of additional references. It is required to provide an additional references with 'CAPACITY_PROVIDER_ACCOUNT_CODE' and 'CAPACITY_PROVIDER_ACCOUNT_GROUP_CODE' names accompanied with appropriate values to reference correct carrier and credentials.

referenceNumbers.​additionalReferences[].​namestring

Indicates the name of the reference number being provided.

referenceNumbers.​additionalReferences[].​valuestring

Additional reference number that correlates to the additional reference name.

paymentobjectrequired

Payment terms related to the shipment such as Prepaid, Collect or Third Party.

payment.​termsstringrequired

An enumeration.

Enum"Prepaid""Collect""Third Party"
commoditiesobjectrequired

Commodities related to the shipment.

commodities.​lineItemLayoutstringrequired

An enumeration.

Enum"Nested""Stacked"
commodities.​handlingUnitsArray of objects(multi_modal_booking_service_public__ebol__ltl__ebol__HandlingUnit)required

A list of the quantity of certain handling unit types.

commodities.​handlingUnits[].​countintegerrequired

Number of handling units being described.

commodities.​handlingUnits[].​typestringrequired

An enumeration.

Enum"BAG""BAL""BBL""BSK""BIN""BOX""BXT""BCH""BDL""CAB""CAG""CAN""CBY""CAR""CTN"
commodities.​handlingUnits[].​tareWeightinteger

Weight of the skids/pallets/slips used in the shipment.

commodities.​handlingUnits[].​weightintegerrequired

Total weight for the specified handling units.

commodities.​handlingUnits[].​weightUnitstring

An enumeration.

Default "Pounds"
Enum"Pounds""Kilograms"
commodities.​handlingUnits[].​lengthinteger

The length of the handling units being described.

commodities.​handlingUnits[].​widthinteger

The width of the handling units being described.

commodities.​handlingUnits[].​heightinteger

The height of the handling units being described.

commodities.​handlingUnits[].​dimensionsUnitstring

An enumeration.

Enum"Inches""Centimeters"
commodities.​handlingUnits[].​stackableboolean

Identifies whether or not the freight being described can be stacked on one another.

Default false
commodities.​handlingUnits[].​lineItemsArray of objects(LineItem)

The list of line items related to the shipment.

shipmentTotalsobject

Measurements related to the shipment.

accessorialsobject

A list of accessorials related to the shipment.

originobjectrequired

A location where the related shipment's pickup should happen.

origin.​accountstring

Company's account number/id.

origin.​locationIdstring

Company's location id.

origin.​namestringrequired

Company name associated with the location.

origin.​address1stringrequired

Primary Address line for the location.

origin.​address2string

Secondary Address line for the location.

origin.​citystringrequired

City Name for the location.

origin.​stateProvincestringrequired

An enumeration.

Enum"AL""AK""AZ""AR""CA""CO""CT""DC""DE""FL""GA""HI""ID""IL""IN"
origin.​postalCodestring[ 5 .. 6 ] charactersrequired

The 5-digit (or 6-characters for Canada) zip code for the destination location.

origin.​countrystringrequired

An enumeration.

Enum"USA""MEX""CAN"
origin.​contactobjectrequired

Object containing contact details for the location.

origin.​contact.​phonestringrequired

Ten digit phone number, without country code and/or dashes, for the destination location's contact person.

origin.​contact.​phoneExtstring

Phone extension for the location's contact person.

origin.​contact.​namestring

Name of the location's contact person.

origin.​contact.​emailstring(email)

Email address of the location's contact person.

destinationobjectrequired

A location where related shipment's delivery should happen.

destination.​accountstring

Company's account number/id.

destination.​locationIdstring

Company's location id.

destination.​namestringrequired

Company name associated with the location.

destination.​address1stringrequired

Primary Address line for the location.

destination.​address2string

Secondary Address line for the location.

destination.​citystringrequired

City Name for the location.

destination.​stateProvincestringrequired

An enumeration.

Enum"AL""AK""AZ""AR""CA""CO""CT""DC""DE""FL""GA""HI""ID""IL""IN"
destination.​postalCodestring[ 5 .. 6 ] charactersrequired

The 5-digit (or 6-characters for Canada) zip code for the destination location.

destination.​countrystringrequired

An enumeration.

Enum"USA""MEX""CAN"
destination.​contactobjectrequired

Object containing contact details for the location.

destination.​contact.​phonestringrequired

Ten digit phone number, without country code and/or dashes, for the destination location's contact person.

destination.​contact.​phoneExtstring

Phone extension for the location's contact person.

destination.​contact.​namestring

Name of the location's contact person.

destination.​contact.​emailstring(email)

Email address of the location's contact person.

billToobjectrequired

A location where related shipment's billing should happen.

billTo.​accountstring

Company's account number/id.

billTo.​locationIdstring

Company's location id.

billTo.​namestringrequired

Company name associated with the location.

billTo.​address1stringrequired

Primary Address line for the location.

billTo.​address2string

Secondary Address line for the location.

billTo.​citystringrequired

City Name for the location.

billTo.​stateProvincestringrequired

An enumeration.

Enum"AL""AK""AZ""AR""CA""CO""CT""DC""DE""FL""GA""HI""ID""IL""IN"
billTo.​postalCodestring[ 5 .. 6 ] charactersrequired

The 5-digit (or 6-characters for Canada) zip code for the destination location.

billTo.​countrystringrequired

An enumeration.

Enum"USA""MEX""CAN"
billTo.​contactobjectrequired

Object containing contact details for the location.

billTo.​contact.​phonestringrequired

Ten digit phone number, without country code and/or dashes, for the destination location's contact person.

billTo.​contact.​phoneExtstring

Phone extension for the location's contact person.

billTo.​contact.​namestring

Name of the location's contact person.

billTo.​contact.​emailstring(email)

Email address of the location's contact person.

customsBrokerobject

Optional field to reference customs broker for cross-border shipments.

curl -i -X POST \
  https://developers.project44.com/_mock/api-reference/api-docs/services/booking/v1/ltl/electronic-bols \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "bol": {
      "requestedPickupDate": "2092-12-01T08:30:00",
      "function": "Create",
      "isTest": true,
      "requestorRole": "Shipper"
    },
    "version": "2.0.1",
    "referenceNumbers": {
      "additionalReferences": [
        {
          "name": "CAPACITY_PROVIDER_ACCOUNT_GROUP_CODE",
          "value": "DEFAULT"
        },
        {
          "name": "CAPACITY_PROVIDER_ACCOUNT_CODE",
          "value": "ABFS"
        }
      ]
    },
    "payment": {
      "terms": "Prepaid"
    },
    "commodities": {
      "lineItemLayout": "Nested",
      "handlingUnits": [
        {
          "count": 2,
          "type": "PAT",
          "weight": 500
        }
      ]
    },
    "origin": {
      "name": "Company XYZ",
      "address1": "275 6TH AVE",
      "city": "SHERMAN",
      "stateProvince": "MS",
      "postalCode": "38869",
      "country": "USA",
      "contact": {
        "phone": "5555555555"
      }
    },
    "destination": {
      "name": "Company 123",
      "address1": "505 PEGASUS PARKWAY",
      "city": "LAGRANGE",
      "stateProvince": "GA",
      "postalCode": "30240",
      "country": "USA",
      "contact": {
        "phone": "5555555556"
      }
    },
    "billTo": {
      "name": "Company 123",
      "address1": "505 PEGASUS PARKWAY",
      "city": "LAGRANGE",
      "stateProvince": "GA",
      "postalCode": "30240",
      "country": "USA",
      "contact": {
        "phone": "5555555556"
      }
    }
  }'

Responses

Successful Response

Bodyapplication/json
versionstringrequired

Indicates which version of the Digital LTL Council Bill of Lading spec was returned. Example: v1

transactionDatestring(date-time)required

The date associated with this electronic bill of lading transaction.

referenceNumbersobjectrequired

Reference numbers related to the eBOL request.

referenceNumbers.​prostringrequired

Shipper's pre-assigned PRO number for the requested carrier. If one was not provided in the request, one will be auto assigned by the carrier.

referenceNumbers.​shipmentConfirmationNumberstringrequired

Number provided by the carrier to acknowledge they accepted the BOL.

imagesobjectrequired

Images related to the eBOL request such as BOL or Shipping Labels.

images.​bolstringrequired

Base 64 encoded PDF of the populated Bill Of Lading.

images.​shippingLabelsstringrequired

Base 64 encoded PDF of the populated shipping labels.

messageStatusobjectrequired

Object containing message status details.

messageStatus.​statusstringrequired

Indicate if the request was successful and if there were exceptions

Enum"PASS""FAIL""WARNING"
messageStatus.​codestring

Indicates response detail code.

messageStatus.​messagestring

Provides information pertaining to the response code.

messageStatus.​resolutionstring

Provides guidance pertaining to the response code.

messageStatus.​informationArray of objects(MessageStatusInformation)

List of information related to the eBOL request.

Response
application/json
{ "version": "string", "transactionDate": "2019-08-24T14:15:22Z", "referenceNumbers": { "pro": "string", "shipmentConfirmationNumber": "string" }, "images": { "bol": "string", "shippingLabels": "string" }, "messageStatus": { "status": "PASS", "code": "string", "message": "string", "resolution": "string", "information": [] } }

Webhook Data

Operations to describe the payload expected from project44 when integrated with a webhook.

Operations

Postal Address Validation

Operations

Parcel: Push Tracking

Operations

location-controller

Operations

Ocean: Tracking

Operations

Stop Location Management

Operations

TL: Webhook

Operations

Push Updates

Operations

Multi-Modal: Booking

Operations

APIs

Operations

Invitations

Operations

Multi-Modal: Document

Operations