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

Download OpenAPI description
Languages
Servers
NA - Endpoint for project44 tenants created in the NA region
https://na12.api.project44.com/
EU - Endpoint for project44 tenants created in the EU region
https://eu12.api.project44.com/
Sandbox - 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 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.

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

Shipment: Tracking

...

Operations

Filter Suggestions

...

Operations

Shipment Attributes

...

Operations

Shipment: Loads

...

Operations

Order Visibility

...

Operations

LTL: Quotes

...

Operations

LTL: Dispatch

...

Operations

LTL: Image Retrieval

...

Operations

LTL: Electronic BOL

API used for creating Electronic BOL

Operations

VLTL: Quotes

...

Operations

VLTL: Dispatch

...

Operations

TL: Available Vehicles

...

Operations

TL: Connected Capacity

...

Operations

Asset Tracking

...

Operations

Multi-Modal: Image Retrieval

...

Operations

Multi-Modal: Rating

API used for multi-modal Rating.

Operations

Multi-Modal: Booking

API used for multi-modal Booking.

Operations

Multi-Modal: Packaging

API used for managing packages for shipment planning.

Operations

Multi-Modal: Document

...

Operations

Webhook

...

Operations

Shipment Webhook Data

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

Operations

Inventory Order and Load Webhook Data

Operations to describe the payload expected from project44 when integrated with a webhook for orders and loads.

Operations

Capacity Provider Metadata

...

Operations

Capacity Provider Contact Management

...

Operations

Capacity Provider Account Management

...

Operations

Capacity Provider Account Group Management

...

Operations

LTL: Push Tracking

...

Operations

LTL: Push Imaging

...

Operations

TL: Capacity Provider Push

...

Operations

Parcel: Push Tracking

...

Operations

Universal Push: Truckload

...

Operations

Push Updates

...

Operations

Analytics: Port Intelligence

...

Operations

Stop Location Management

...

Operations

Postal Address Validation

...

Operations

Appointments

Create, reschedule, cancel, fetch appointments in Yard Management Systems(YMS)

Operations

Capacity

Get capacity for a YMS site within the specified time range

Operations

Milestones

Update yard milestones for a shipment

Operations

Reason Codes

Retrieve all reason codes for the specified YMS site

Operations

Site Codes

Retrieve all sites for the specified YMS tenant

Operations

Slots

Get available slots for a shipment in Yard Management Systems(YMS)

Operations

Invitations

...

Operations

Ocean: Point-to-Point Schedules

...

Operations

List Carriers

Request

curl -i -X GET \
  https://na12.api.project44.com/services/advanced-sailing-schedules/v1/carriers \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful Response

Bodyapplication/json
carriersArray of objects(Carriers)

Carriers currently live in the service.

Response
application/json
{ "carriers": [ {} ] }

Search Point To Point Routes

Request

Query
originstring(Origin)required

Origin UN/LOCODE, e.g. NLRTM

destinationstring(Destination)required

Destination UN/LOCODE, e.g. USLGB

departureStartDatestring(date)(Departurestartdate)

Earliest departure date (inclusive), in the origin port's local zone. Must be paired with departureEndDate. At least one complete window (departure and/or arrival) is required; the two windows combine with AND when both are given.

departureEndDatestring(date)(Departureenddate)

Latest departure date (inclusive), in the origin port's local zone. Must be paired with departureStartDate.

arrivalStartDatestring(date)(Arrivalstartdate)

Earliest arrival date (inclusive), in the destination port's local zone. Must be paired with arrivalEndDate.

arrivalEndDatestring(date)(Arrivalenddate)

Latest arrival date (inclusive), in the destination port's local zone. Must be paired with arrivalStartDate.

carrierCodesstring(Carriercodes)

Comma-separated SCAC list, e.g. carrierCodes=ONEY,MAEU. Must be a single repeated-comma string, not a repeated query param — carrierCodes=ONEY&carrierCodes=MAEU silently keeps only the last value.

transshipmentsMaxinteger(Transshipmentsmax)[ 0 .. 10 ]
sortstring(SailingScheduleSortKey)

Sort key for point-to-point route search results. All orderings are ascending.

Default "DEPARTURE_DATE_TIME"
Enum"DEPARTURE_DATE_TIME""ARRIVAL_DATE_TIME""TRANSIT_TIME"
pageNumberinteger(Pagenumber)>= 1
Default 1
pageSizeinteger(Pagesize)[ 1 .. 200 ]
Default 50
curl -i -X GET \
  'https://na12.api.project44.com/services/advanced-sailing-schedules/v1/point-to-point-routes?arrivalEndDate=2019-08-24&arrivalStartDate=2019-08-24&carrierCodes=string&departureEndDate=2019-08-24&departureStartDate=2019-08-24&destination=string&origin=string&pageNumber=1&pageSize=50&sort=DEPARTURE_DATE_TIME&transshipmentsMax=10' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful Response

Bodyapplication/json
paginationInfoobject(Paginationinfo)

Pagination information about a collection of resources.

resultsArray of objects(Results)

List of resources contained on this page.

Response
application/json
{ "paginationInfo": { "pageSize": 0, "pageNumber": 0, "total": 0 }, "results": [ {} ] }

LTL: Tracking

...

Operations

TL: Tracking

...

Operations

TL: Webhook

...

Operations

Parcel: Tracking

...

Operations

Parcel: Webhook

...

Operations

Rail: Tracking

...

Operations

Ocean: Tracking

...

Operations