# API specifications

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

The API specifications are [available on GitHub](https://github.com/commercetools/commercetools-api-reference). They are free to use and updated when changes are made to the 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 APIs.

APIs are described in two formats: [RAML](https://raml.org/) (RESTful API Modeling Language) and [OAS](https://www.openapis.org/) (OpenAPI Specification).

API specifications for Connect are not available in OAS.

| API | Specifications |
| --- | --- |
| [HTTP API](/api/) | [RAML](https://github.com/commercetools/commercetools-api-reference/tree/main/api-specs/api), [OAS](https://github.com/commercetools/commercetools-api-reference/tree/main/oas/api) |
| [Import](/api/import-export/overview.md) | [RAML](https://github.com/commercetools/commercetools-api-reference/tree/main/api-specs/import), [OAS](https://github.com/commercetools/commercetools-api-reference/tree/main/oas/import) |
| [Audit Log](/api/history/overview.md) | [RAML](https://github.com/commercetools/commercetools-api-reference/tree/main/api-specs/history), [OAS](https://github.com/commercetools/commercetools-api-reference/tree/main/oas/history) |
| [Checkout](/checkout) | [RAML](https://github.com/commercetools/commercetools-api-reference/tree/main/api-specs/checkout), [OAS](https://github.com/commercetools/commercetools-api-reference/tree/main/oas/checkout) |
| [Connect](/connect) | [RAML](https://github.com/commercetools/commercetools-api-reference/tree/main/api-specs/connect) |

## GraphQL schema

The schema for our [GraphQL API](/api/graphql.md) is [available on GitHub](https://github.com/commercetools/commercetools-api-reference/tree/main/api-specs/graphql).

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

Diagrams for the HTTP API are [available on GitHub](https://github.com/commercetools/commercetools-api-reference/tree/main/uml/api).

## Related pages

- [Area overview page with navigation](/dev-tooling.md)
- [Previous page: Bruno collections](/dev-tooling/bruno.md)