Get Receipt by CID

Terminals key receipts by a cid UUID, so integrations often hold that rather than the numeric id. Returns exactly the same payload as fetching by id.

HTTP Request

GET https://integrations.clopos.com/open-api/v2/receipts/cid/{cid}

This endpoint requires authentication. Include your JWT in the x-token header. See Authentication for how to obtain a token and Errors for error responses.

Access

Requirement	Value
Integrator scope	`receipts:read`
User ability	`RECEIPT_VIEW`

The integration user must hold the ability as well as the scope — the scope alone is not enough.

Request Example

curl --location "https://integrations.clopos.com/open-api/v2/receipts/cid/96ab5d26-d6bb-4976-a6f8-9e8806ef6aa5" \
  -H "x-token: oauth_example_token"

const response = await fetch('https://integrations.clopos.com/open-api/v2/receipts/cid/96ab5d26-d6bb-4976-a6f8-9e8806ef6aa5', {
  headers: { 'x-token': 'oauth_example_token' }
});
const data = await response.json();

import requests

response = requests.get(
    "https://integrations.clopos.com/open-api/v2/receipts/cid/96ab5d26-d6bb-4976-a6f8-9e8806ef6aa5",
    headers={"x-token": "oauth_example_token"},
)
data = response.json()

Notes

The cid must be a well-formed UUID; anything else returns 400 without reaching the API.

Overview

Auth

Venues

Users

Customers

Categories

Station

Products

Price Lists

Sales

Orders

Receipts

Inventory

Finance

Tables

HTTP Request

Access

Request Example

Notes

​HTTP Request

​Access

​Request Example

​Notes

HTTP Request

Access

Request Example

Notes