Quick Start

The Oracle Commerce Cloud REST APIs consist of several sets of endpoints:
  • The Store API endpoints provide access to the storefront.
  • The Admin API endpoints provide access to administrative functionality on the administration server. Two subsets of the Admin API endpoints, the Search Admin and Configuration and the Search Data and Indexing API endpoints, provide access to search functionality on the search server.
  • The Agent API endpoints provide access to agent functionality on the administration server.
  • The Social Wish Lists API endpoints are used to configure wish list features.
In addition to the endpoints, Oracle Commerce Cloud provides webhooks for making calls to external systems.

Each set of endpoints is different, although in many cases similar endpoints are available in multiple APIs. For example, the Store, Agent, and Admin APIs all have endpoints for working with orders, though they differ in the functions that they can perform.

Authentication is handled separately for each API. For example, logging into the Admin API does not give you access to the Agent endpoints. In addition, each API's endpoints differ in terms of which user roles provide access to them. For example, an account with CS Agent permissions does not necessarily also include Administrator permissions.

Note that each API is available only in certain environments:
  • The Admin API and Agent API are available on the administration server only.
  • The Store API is available primarily on the storefront server. It is also available on the administration server for previewing unpublished changes to the store.