Skip to main content
Version 2 of the Clopos Open API introduces JWT-based authentication and simplifies request headers. After authentication you only need to send x-token with each call.

​
Base URL

https://integrations.clopos.com/open-api/v2

​
What changed in v2

  • Endpoints live under /open-api/v2.
  • /auth now requires an integrator_id along with your existing client credentials.
  • venue_id is not part of the auth payload.
  • Subsequent requests require only the x-token header; brand and venue headers are no longer needed.
  • Auth responses now return both expires_in and expires_at (epoch seconds).

​
Authentication flow

1

Collect credentials

Use your client_id, client_secret, brand, and integrator_id.
2

Call /v2/auth

Exchange credentials for a JWT access token and note the expires_at value.
3

Call other endpoints

Include only x-token with the JWT you received.

​
Required header for all v2 endpoints (except /auth)

x-token: your_jwt_token_here

​
Sample authenticated request

curl -X GET https://integrations.clopos.com/open-api/v2/orders \
  -H "x-token: your_jwt_token_here"