Skip to main content

​
Welcome to Clopos Open API

The Clopos Open API provides secure and unified access to the Clopos ecosystem, enabling seamless integration of POS, ordering, payments, and restaurant management services.

Quick Start

Get up and running with the Clopos API in minutes

Authentication

Learn how to authenticate and secure your API requests

API Reference

Explore all available endpoints and their usage

Support

Get help from our development team

​
What you can do with the Clopos API

Use OAuth 2.0 tokens scoped to specific brands and venues for secure access to your data.
Access and manage products, menus, orders, receipts, payments, and customers with comprehensive CRUD operations.
Built-in pagination, filtering, and sorting capabilities across all endpoints for efficient data retrieval.
Streamline order synchronization, payment reconciliation, and reporting processes.
Build custom dashboards, delivery integrations, and mobile applications on top of our platform.

​
Base URL

All API requests should be made to: 
https://integrations.clopos.com/open-api

​
API Version

Current API version: v2. Version 1 is deprecated and no longer appears in the navigation; existing integrations can still reach v1 pages by direct link while you migrate.

​
Getting Started

Follow these steps to go from zero to a working integration:

​
1. Request access credentials

  • Request API access by filling out this form. Clopos will issue your client_id, client_secret, brand, and integrator_id.
  • Store all four credentials securely; never commit secrets to source control.

​
2. Authenticate against v2

  • Send a POST request to https://integrations.clopos.com/open-api/v2/auth with your credentials: 
    {
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "brand": "your_brand",
  "integrator_id": "your_integrator_id"
}
  • On success, you receive a JWT: 
    {
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "expires_at": 1767852332,
  "message": "Authentication successful"
}
  • Tokens expire after expires_in seconds. Refresh them before they expire to avoid request failures.

​
3. Call your first endpoint

  • Include the JWT in the x-token header. brand, venue_id, and integrator_id are encoded in the token, so no additional headers are needed.
  • Example cURL request to list products: 
    curl -X GET "https://integrations.clopos.com/open-api/v2/products" \
  -H "x-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  • You can filter by product type, category, tags, and many more fields.

​
4. Explore the API surface

Need help? Contact our team at [email protected].