The purpose of this page is to describe the headless Max API service that enables rapid experience-first commerce development and applications.

Max API follows a microservice architecture that enables commerce into any part of an application and is built on the JSON API specification, follows predictable REST URLs, and supports cross-origin resource sharing.


To authenticate ichronos APIs, you require an API Key. For authenticating Search APIs, you need API Key and Bearer Token (Salesforce Access Token).


Max APIs can be exposed to external applications via a Salesforce site or community. Max APIs have the following base URL: 


The Max API ensures backward compatibility by properly versioning any changes to the APIs. Should changes to the API structure need to be made, it will occur within a new version and older functionality will be preserved.

Content Type

Requests made to the API must be encoded as JSON and contain the header

Content-Type: application/json


Any request that returns an error follows a standard format. The Max APIs will return an array of errors that contains objects containing the status, title and data with the error details.

400Invalid JSON
429Rate Limit Exceeded
422Validation Error
500Something went wrong on our end