List active products
Lists active immutable products plus a discovery-only family view. Orders and quotes always use the concrete product ID and revision. Deprecated catalog records remain available only to trusted historical decoding and are not publicly discoverable.
curl --request GET \
--url https://api.batchrelay.com/v1/catalog/productsimport requests
url = "https://api.batchrelay.com/v1/catalog/products"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.batchrelay.com/v1/catalog/products', 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.batchrelay.com/v1/catalog/products",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.batchrelay.com/v1/catalog/products"
req, _ := http.NewRequest("GET", url, nil)
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.batchrelay.com/v1/catalog/products")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.batchrelay.com/v1/catalog/products")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"catalog_revision": "<string>",
"checksum": "<string>",
"families": [
{
"id": "<string>",
"name": "<string>",
"variants": [
{
"attributes": {},
"product": {
"id": "<string>",
"revision": 2
}
}
]
}
],
"products": [
{
"fulfillment_type": "print",
"tax_category": "physical_print",
"asset_requirements": [
{
"aspect_ratio": {
"height": 2,
"width": 2
},
"required": true,
"role": "artwork",
"rotation_policy": "fixed"
}
],
"category": "prints",
"description": "<string>",
"family": {
"id": "<string>",
"name": "<string>"
},
"id": "<string>",
"lifecycle": {
"status": "active",
"replacement_product_id": "<string>"
},
"name": "<string>",
"options": [
{
"affects_price": true,
"default_value": "<string>",
"id": "<string>",
"name": "<string>",
"values": [
"<string>"
]
}
],
"physical_output": {
"height": 123,
"unit": "inches",
"width": 123
},
"revision": 2,
"template_requirement": "required",
"unit_costs": [
{
"option_values": [
{
"option_id": "<string>",
"value": "<string>"
}
],
"pricing_status": "unverified",
"unit_cost_cents": 1
}
],
"units_per_quantity": 2,
"variant_attributes": {},
"consumer_quantity": {
"unit_plural": "<string>",
"unit_singular": "<string>",
"container_plural": "<string>",
"container_singular": "<string>"
},
"fulfillment_target": {
"id": "<string>",
"revision": 2
},
"prepared_artwork": {
"finished_area": {
"kind": "rectangle",
"center_in": {
"x": 1,
"y": 1
},
"diameter_in": 123,
"inset_in": {
"bottom": 1,
"left": 1,
"right": 1,
"top": 1
}
},
"important_content_area": {
"kind": "rectangle",
"center_in": {
"x": 1,
"y": 1
},
"diameter_in": 123,
"inset_in": {
"bottom": 1,
"left": 1,
"right": 1,
"top": 1
}
},
"output_bounds_in": {
"height": 123,
"width": 123
},
"output_dpi": 636
},
"print_safety_profile": {
"expected_trim_fraction_per_edge": 1,
"id": "<string>",
"important_content_inset_in": 1,
"minimum_border_inset_in": 1,
"trim_bottom_in": 1,
"trim_left_in": 1,
"trim_right_in": 1,
"trim_top_in": 1,
"version": 2,
"mounted": true
},
"text_requirements": [
{
"allow_blank": true,
"name": "<string>",
"slot": "text-1"
}
]
}
]
}Headers
Untrusted optional analytics hint naming the calling client surface. It never affects authorization, routing, pricing, or behavior.
1 - 100Untrusted optional analytics hint naming the calling client version. It never affects authorization, routing, pricing, or behavior.
1 - 100Untrusted optional analytics hint naming the invocation mode. It never affects authorization, routing, pricing, or behavior.
1 - 100Response
Active public catalog. ETag equals the quoted deterministic checksum and supports If-None-Match conditional reads.
Public catalog response. catalog_revision and checksum are deterministic SHA-256 values for this active catalog projection. Families group active variants for discovery; products remain the immutable order contract. Every listed product has lifecycle.status=active; deprecated records are intentionally excluded.
curl --request GET \
--url https://api.batchrelay.com/v1/catalog/productsimport requests
url = "https://api.batchrelay.com/v1/catalog/products"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.batchrelay.com/v1/catalog/products', 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.batchrelay.com/v1/catalog/products",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.batchrelay.com/v1/catalog/products"
req, _ := http.NewRequest("GET", url, nil)
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.batchrelay.com/v1/catalog/products")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.batchrelay.com/v1/catalog/products")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"catalog_revision": "<string>",
"checksum": "<string>",
"families": [
{
"id": "<string>",
"name": "<string>",
"variants": [
{
"attributes": {},
"product": {
"id": "<string>",
"revision": 2
}
}
]
}
],
"products": [
{
"fulfillment_type": "print",
"tax_category": "physical_print",
"asset_requirements": [
{
"aspect_ratio": {
"height": 2,
"width": 2
},
"required": true,
"role": "artwork",
"rotation_policy": "fixed"
}
],
"category": "prints",
"description": "<string>",
"family": {
"id": "<string>",
"name": "<string>"
},
"id": "<string>",
"lifecycle": {
"status": "active",
"replacement_product_id": "<string>"
},
"name": "<string>",
"options": [
{
"affects_price": true,
"default_value": "<string>",
"id": "<string>",
"name": "<string>",
"values": [
"<string>"
]
}
],
"physical_output": {
"height": 123,
"unit": "inches",
"width": 123
},
"revision": 2,
"template_requirement": "required",
"unit_costs": [
{
"option_values": [
{
"option_id": "<string>",
"value": "<string>"
}
],
"pricing_status": "unverified",
"unit_cost_cents": 1
}
],
"units_per_quantity": 2,
"variant_attributes": {},
"consumer_quantity": {
"unit_plural": "<string>",
"unit_singular": "<string>",
"container_plural": "<string>",
"container_singular": "<string>"
},
"fulfillment_target": {
"id": "<string>",
"revision": 2
},
"prepared_artwork": {
"finished_area": {
"kind": "rectangle",
"center_in": {
"x": 1,
"y": 1
},
"diameter_in": 123,
"inset_in": {
"bottom": 1,
"left": 1,
"right": 1,
"top": 1
}
},
"important_content_area": {
"kind": "rectangle",
"center_in": {
"x": 1,
"y": 1
},
"diameter_in": 123,
"inset_in": {
"bottom": 1,
"left": 1,
"right": 1,
"top": 1
}
},
"output_bounds_in": {
"height": 123,
"width": 123
},
"output_dpi": 636
},
"print_safety_profile": {
"expected_trim_fraction_per_edge": 1,
"id": "<string>",
"important_content_inset_in": 1,
"minimum_border_inset_in": 1,
"trim_bottom_in": 1,
"trim_left_in": 1,
"trim_right_in": 1,
"trim_top_in": 1,
"version": 2,
"mounted": true
},
"text_requirements": [
{
"allow_blank": true,
"name": "<string>",
"slot": "text-1"
}
]
}
]
}