Support

Traffic and spike arrest limits are configured at the consumer key level for each API Product as detailed in the table below. If these limits are exceeded, the request is rejected with a 429 Too Many Requests HTTP status code.

Maximum of 10 apps are possible for each developer.

Yes. Up to 10 API keys per app are possible.

It doesn’t expire. The developer can revoke and recreate keys as needed.

Our Customer APIs are exclusively available to Maersk’s current business partners.  To use these APIs, you need to provide at least one Maersk customer code.  If you are logged in using a free email account, you will not be able to use our Customer APIs.  Please register using your official company email address and provide at least one Maersk customer code.  If you cannot locate your Customer Code, please contact your local Maersk office.

First, create your app or add your new key with 5 Maersk customer codes.  Then contact us with the list of additional customer codes you would like to add to your key.  Please be sure to provide us with your registered email address and the value of your consumer key.

We currently do not allow you to add or remove customer codes from an existing consumer key.  Please create a new key and add the codes for the Maersk customer resources you need to access using our API Products.

To access API Products requiring OAuth 2.0 authentication, Maersk has implemented the client credentials flow. This ensures secure, time-limited access to our API resources. For detailed instructions how to obtain an access token required for authentication, please refer to our step-by-step Authorisation Guide.

If you are not registered and logged in to the portal, you will be able to view specs for only those API Products that are supported by a mock service. Otherwise you are prompted to login to the portal to view the specs and endpoints for our live environments.

A mock service simulates API requests and responses for evaluation and testing purposes. Our mock services are based on actual scenarios that allow developers to quickly determine if the API Product is suited to their needs and integrate our APIs without external dependencies.

Our mock services are available in the API Catalogue for developers who are not logged in to the portal. If you are logged in to the portal, you can view specs for the API Products that are supported by a mock service when you logout.

No. Currently, our APIs are free to use. However, we reserve the right to implement a payment plan in the future for your use of any of our APIs and services as defined by our API License Terms.

Maersk is member of the DCSA and supports the goal of establishing the technological foundation for interoperable IT solutions. Maersk will release APIs in accordance to the available DCSA standards and if at any point the DCSA releases a new or updated standard Maersk will adopt accordingly. For more information regarding DCSA initiatives please visit https://dcsa.org/.

Our API endpoints restrict requests from an IP address to a maximum of 5 POST requests and 20 non-POST requests per second. This includes requests responding with 4xx or 5xx errors. Your app has likely exceeded the quota. Configure your app to use exponential backoff or some other retry logic to decrease the rate of calls to the API. If the problem persists, we will work with you to resolve the issue. Please provide your external IP address, targeted endpoints and date and time of error using our contact us form.

Traffic and spike arrest limits are set at the consumer key level for each API Product as detailed in the table below. If these limits are exceeded, the request is rejected with a 429 Too Many Requests HTTP status code. Configure your app to use exponential backoff or some other retry logic to decrease the rate of calls to the API. If the problem persists, we will work with you to resolve the issue. Please provide your consumer key, targeted endpoints and date and time of error using our contact us form.

To troubleshoot SSL Handshake errors, please follow these steps:

1. System date and time: Ensure that your system's date and time are correctly set. An incorrect date and time can cause SSL handshake failures because SSL certificates have a validity period.

2. Network Issues: Ensure api.maersk.com is whitelisted on your firewall.

3. SSL/TLS Protocol Version & Cipher Suites: Run the SSL server test for api.maersk.com:

Ensure your server supports the SSL/TLS protocol version and cipher suites offered by api.maersk.com.

4. Verify SSL Certificates: Make sure your SSL certificate is valid, not expired and issued by a trusted Certificate Authority (CA). See the following link for more information:

Ensure your certificate store contains a valid certificate issued to api.maersk.com.

5. Contact Us: If you still are unable to successfully connect to our API endpoint, please contact us with the following details:

• Run the following command and share the results:
echo | openssl s_client -servername api.maersk.com -connect api.maersk.com:443
• Run the following command and share the results:
curl -v https://api.maersk.com
• Provide TCP Dump files and any log files related to the handshake error.

Current and future Maersk customers are eligible for EDI solutions. All requests will be reviewed prior to integration for eligibility. If you have any questions about eligibility, please do not hesitate to contact us.

Current and future Maersk customers are eligible for EDI solutions. All requests will be reviewed prior to integration for eligibility, but if you have any questions about eligibility please contact our team for further support.

There is no limit to the number of EDI messages that can be integrated. The number of EDI solutions may vary depending on your company’s need, eligibility and requirements.

The integration timeline varies across message types and the overall number of messages being integrated. Once an EDI analyst has reviewed the requirements in detail, a more specific integration timeline can be established.

Your password is valid for a period of 12 months. You will receive an email containing a link to reset your password when it expires. If you do not receive the link, you can reset your password here.

You can reset your password here.

Email addresses cannot be edited. You must delete your account and recreate it using your new email address. Before you delete your account, you must delete your Apps and Consumer Keys. You can create new Apps and Consumer Keys when you create your new account with your updated/new email address.

You can delete your account here.