Lookup by barcode
curl --request GET \
--url https://app.colacloud.us/api/v1/barcode/{barcode_value} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.colacloud.us/api/v1/barcode/{barcode_value}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.colacloud.us/api/v1/barcode/{barcode_value}', 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://app.colacloud.us/api/v1/barcode/{barcode_value}",
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>"
],
]);
$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://app.colacloud.us/api/v1/barcode/{barcode_value}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<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://app.colacloud.us/api/v1/barcode/{barcode_value}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.colacloud.us/api/v1/barcode/{barcode_value}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"barcode_value": "<string>",
"barcode_type": "<string>",
"colas": [
{
"ttb_id": "<string>",
"brand_name": "<string>",
"product_name": "<string>",
"product_type": "wine",
"class_name": "<string>",
"origin_name": "<string>",
"applicant_trade_name": "<string>",
"permit_number": "<string>",
"application_status": "approved",
"approval_date": "2023-12-25",
"image_count": 123,
"has_barcode": true
}
],
"total_colas": 123
}
}Barcodes
Lookup by barcode
Find COLAs by barcode value (UPC, EAN, etc.). Returns up to 100 COLAs associated with the given barcode, subject to remaining quota. The supplied value is matched exactly first. On a miss, numeric whitespace and hyphen separators are removed. If still unmatched, a checksum-valid 12-digit UPC-A may match its zero-prefixed EAN-13, or a zero-prefixed 13-digit EAN may match its 12-digit UPC-A. Leading-zero recovery requires the corresponding stored barcode type (ean13 or upca). The first matching value wins; results from variants are never combined. No fuzzy matching, check-digit repair, UPC-E expansion, or GTIN-14 conversion is performed. The response barcode_value echoes the supplied value; barcode_type describes the matched stored barcode.
GET
/
barcode
/
{barcode_value}
Lookup by barcode
curl --request GET \
--url https://app.colacloud.us/api/v1/barcode/{barcode_value} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.colacloud.us/api/v1/barcode/{barcode_value}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.colacloud.us/api/v1/barcode/{barcode_value}', 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://app.colacloud.us/api/v1/barcode/{barcode_value}",
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>"
],
]);
$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://app.colacloud.us/api/v1/barcode/{barcode_value}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<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://app.colacloud.us/api/v1/barcode/{barcode_value}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.colacloud.us/api/v1/barcode/{barcode_value}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"barcode_value": "<string>",
"barcode_type": "<string>",
"colas": [
{
"ttb_id": "<string>",
"brand_name": "<string>",
"product_name": "<string>",
"product_type": "wine",
"class_name": "<string>",
"origin_name": "<string>",
"applicant_trade_name": "<string>",
"permit_number": "<string>",
"application_status": "approved",
"approval_date": "2023-12-25",
"image_count": 123,
"has_barcode": true
}
],
"total_colas": 123
}
}