API specifications

Explore Composable Commerce APIs using RAML, OAS, GraphQL, and UML files.

The specifications of commercetools Composable Commerce APIs are available on GitHub. They are free to use and updated when changes are made to the Composable Commerce APIs.

You can use these specifications to create tools such as:

  • Code generators to build client libraries in different languages
  • Validators to check that requests and responses match the API contract
  • Mock servers to test and prototype without a live project
  • Custom extensions to enhance SDKs, IDEs, or other developer tools
  • Automation scripts to run bulk data imports or testing tasks

Using these specifications helps you integrate faster, reduce errors, and stay compatible with Composable Commerce APIs.

API specifications for Checkout and Connect are not available in OAS.

APISpecifications
HTTP APIRAML, OAS
ImportRAML, OAS
Audit LogRAML, OAS
CheckoutRAML
ConnectRAML

GraphQL schema

UML diagrams

UML (Unified Modeling Language) diagrams help you visualize the structure, relationships, and data flow of an API, making it easier to understand and work with complex systems.