curl --request GET \
--url https://api.atlas.kitchen/admin/v1/cash_vouchers/{id} \
--header 'X-Api-Key: <api-key>' \
--header 'X-Merchant-Id: <api-key>'import requests
url = "https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}"
headers = {
"X-Api-Key": "<api-key>",
"X-Merchant-Id": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Api-Key': '<api-key>', 'X-Merchant-Id': '<api-key>'}
};
fetch('https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>",
"X-Merchant-Id: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("X-Merchant-Id", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}")
.header("X-Api-Key", "<api-key>")
.header("X-Merchant-Id", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
request["X-Merchant-Id"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 123,
"label": "External gift voucher",
"description": "Issued by external gift-card platform",
"code": "EXT-ABC123",
"value": 5000,
"expires_after": "2026-12-31",
"unique": true,
"outlet_ids": [
1,
2
],
"status": "active",
"redemptions_count": 0,
"created_at": 1781615664,
"updated_at": 1781615664
}{
"type": "<string>",
"message": "<string>",
"error_hash": {}
}Cash voucher details
curl --request GET \
--url https://api.atlas.kitchen/admin/v1/cash_vouchers/{id} \
--header 'X-Api-Key: <api-key>' \
--header 'X-Merchant-Id: <api-key>'import requests
url = "https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}"
headers = {
"X-Api-Key": "<api-key>",
"X-Merchant-Id": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Api-Key': '<api-key>', 'X-Merchant-Id': '<api-key>'}
};
fetch('https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>",
"X-Merchant-Id: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("X-Merchant-Id", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}")
.header("X-Api-Key", "<api-key>")
.header("X-Merchant-Id", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.atlas.kitchen/admin/v1/cash_vouchers/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
request["X-Merchant-Id"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 123,
"label": "External gift voucher",
"description": "Issued by external gift-card platform",
"code": "EXT-ABC123",
"value": 5000,
"expires_after": "2026-12-31",
"unique": true,
"outlet_ids": [
1,
2
],
"status": "active",
"redemptions_count": 0,
"created_at": 1781615664,
"updated_at": 1781615664
}{
"type": "<string>",
"message": "<string>",
"error_hash": {}
}Authorizations
Your API key provided during onboarding. Example c2fb5ae6ea99c37d...
Your numeric merchant ID. Example 1
Path Parameters
Response
Cash voucher
Atlas cash voucher ID.
123
Display label for the voucher.
"External gift voucher"
Optional note or campaign description for the voucher.
"Issued by external gift-card platform"
Customer-facing redemption code. Atlas stores codes in uppercase without whitespace.
"EXT-ABC123"
Voucher value in minor currency units (cents). For example, 5000 means $50.00.
5000
Last valid service date for redemption, in ISO 8601 date format. A voucher with expires_after: 2026-12-31 is redeemable on 2026-12-31 and expires on 2027-01-01.
"2026-12-31"
Whether the voucher can only be redeemed once. Defaults to true when omitted on create.
true
Outlet IDs where the POS picker shows this voucher. An empty array means all outlets. This setting does not block manual code redemption at other outlets.
[1, 2]
Computed voucher state. expired wins when expires_after is in the past; redeemed applies to non-expired unique vouchers with a captured redemption; otherwise the voucher is active.
active, expired, redeemed "active"
Number of redeemed voucher units, excluding fully refunded cash voucher payments.
0
Unix epoch timestamp in seconds.
1781615664
Unix epoch timestamp in seconds.
1781615664
Was this page helpful?