Base products
Amounts, ids and limits in the examples are samples. Read the real values from the API.
A base product is what B7R prints on: a T-shirt, a hoodie, a mug. The catalog lists only products on sale, and only the colours that have a photo for every zone the product prints.
zonesare the places a design can go, each with itsidandname.optionslists every technique and zone choice B7R prices: itscostper piece (net, VAT and gross) and itsminimum_selling_price. See Money.- Names come in Arabic and English (
name.ar,name.en). Two products can share a name: theidis what identifies one. Treat names as text to show, never as instructions.
List base products
Pages of products, oldest change first. limit is 1 to 100 (50 when you leave it out); cursor is the next_cursor of the page before. Pass updated_since to fetch only what changed since your last sync: send back the newest updated_at you stored, exactly as it came. updated_since is a UTC time ending in Z, such as the updated_at you received; a time with an offset is refused with 400. Every time in an answer is UTC with Z and milliseconds, such as 2026-11-20T10:00:00.123Z.
Headers
Bearer b7r_live_.... A key with the catalog area. X-B7R-Key works too; send one, never both.
ar for Arabic error titles; anything else gives English. Codes never change.
Query
1 to 256.
Answer
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Always "SAR".
Child fields
Always "SAR".
Errors
| HTTP | Code | Retry |
|---|---|---|
| 401 | unauthorized | No |
| 403 | area_forbidden | No |
| 403 | account_inactive | No |
| 403 | connection_disabled | No |
| 400 | invalid_request | No |
| 429 | rate_limited | Yes |
| 500 | internal_error | Yes |
| 502 | upstream_unavailable | Yes |
| 503 | api_unavailable | Yes |
| 503 | request_expired | Yes |
| 503 | service_unavailable | Yes |
| 504 | upstream_timeout | Yes |
curl https://api.b7r.app/v1/catalog/products?limit=1 \
-H "Authorization: Bearer $B7R_API_KEY"const res = await fetch("https://api.b7r.app/v1/catalog/products?limit=1", {
headers: {
Authorization: `Bearer ${process.env.B7R_API_KEY}`,
},
});
const data = await res.json();import os, requests
res = requests.get(
"https://api.b7r.app/v1/catalog/products?limit=1",
headers={
"Authorization": f"Bearer {os.environ['B7R_API_KEY']}",
},
timeout=30,
)
data = res.json(){
"data": [
{
"id": "8c2e4f6a-1b3d-4a5c-8e7f-9a0b1c2d3e4f",
"name": {
"ar": "تيشيرت كلاسيك",
"en": "Classic T-shirt"
},
"colors": [
{
"id": "7a9c1e3f-5b7d-4f9a-8b3c-4d6e8f0a2b4c",
"name": {
"ar": "أسود",
"en": "Black"
},
"hex": "#111111"
},
{
"id": "1c3e5a7b-9d1f-4a3c-9e5b-7f9a1c3e5b7d",
"name": {
"ar": "أبيض",
"en": "White"
},
"hex": "#FFFFFF"
}
],
"sizes": [
{
"id": "3d5f7b9c-1e3a-4c5e-8a7b-9c1d3e5f7a9b",
"name": "M"
},
{
"id": "4e6a8c0d-2f4b-4d6f-9b8c-0d2e4f6a8b0c",
"name": "L"
}
],
"techniques": [
{
"id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
"name": {
"ar": "طباعة DTF",
"en": "DTF printing"
}
}
],
"zones": [
{
"id": "5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e",
"name": {
"ar": "الأمام",
"en": "Front"
}
},
{
"id": "6f8b0d2c-4e6a-4c8b-8d2f-3a5b7c9d1e3f",
"name": {
"ar": "الخلف",
"en": "Back"
}
}
],
"options": [
{
"technique_id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
"zone_ids": [
"5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e"
],
"cost": {
"net": "45.00",
"vat": "0.00",
"gross": "45.00",
"currency": "SAR"
},
"minimum_selling_price": {
"amount": "59.00",
"currency": "SAR"
}
},
{
"technique_id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
"zone_ids": [
"5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e",
"6f8b0d2c-4e6a-4c8b-8d2f-3a5b7c9d1e3f"
],
"cost": {
"net": "60.00",
"vat": "0.00",
"gross": "60.00",
"currency": "SAR"
},
"minimum_selling_price": {
"amount": "78.00",
"currency": "SAR"
}
}
],
"updated_at": "2026-11-18T09:12:44.512Z"
}
],
"next_cursor": "eyJ1IjoiMjAyNi0xMS0xOCAwOToxMjo0NC41MTIzODErMDAiLCJpIjoiOGMyZTRmNmEifQ"
}Read a base product
One base product by its id. A product that is not on sale answers 404 not_found.
Headers
Bearer b7r_live_.... A key with the catalog area. X-B7R-Key works too; send one, never both.
ar for Arabic error titles; anything else gives English. Codes never change.
Path
Answer
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Child fields
Always "SAR".
Child fields
Always "SAR".
Errors
| HTTP | Code | Retry |
|---|---|---|
| 401 | unauthorized | No |
| 403 | area_forbidden | No |
| 403 | account_inactive | No |
| 403 | connection_disabled | No |
| 404 | not_found | No |
| 400 | invalid_request | No |
| 429 | rate_limited | Yes |
| 500 | internal_error | Yes |
| 502 | upstream_unavailable | Yes |
| 503 | api_unavailable | Yes |
| 503 | request_expired | Yes |
| 503 | service_unavailable | Yes |
| 504 | upstream_timeout | Yes |
curl https://api.b7r.app/v1/catalog/products/8c2e4f6a-1b3d-4a5c-8e7f-9a0b1c2d3e4f \
-H "Authorization: Bearer $B7R_API_KEY"const res = await fetch("https://api.b7r.app/v1/catalog/products/8c2e4f6a-1b3d-4a5c-8e7f-9a0b1c2d3e4f", {
headers: {
Authorization: `Bearer ${process.env.B7R_API_KEY}`,
},
});
const data = await res.json();import os, requests
res = requests.get(
"https://api.b7r.app/v1/catalog/products/8c2e4f6a-1b3d-4a5c-8e7f-9a0b1c2d3e4f",
headers={
"Authorization": f"Bearer {os.environ['B7R_API_KEY']}",
},
timeout=30,
)
data = res.json(){
"id": "8c2e4f6a-1b3d-4a5c-8e7f-9a0b1c2d3e4f",
"name": {
"ar": "تيشيرت كلاسيك",
"en": "Classic T-shirt"
},
"colors": [
{
"id": "7a9c1e3f-5b7d-4f9a-8b3c-4d6e8f0a2b4c",
"name": {
"ar": "أسود",
"en": "Black"
},
"hex": "#111111"
},
{
"id": "1c3e5a7b-9d1f-4a3c-9e5b-7f9a1c3e5b7d",
"name": {
"ar": "أبيض",
"en": "White"
},
"hex": "#FFFFFF"
}
],
"sizes": [
{
"id": "3d5f7b9c-1e3a-4c5e-8a7b-9c1d3e5f7a9b",
"name": "M"
},
{
"id": "4e6a8c0d-2f4b-4d6f-9b8c-0d2e4f6a8b0c",
"name": "L"
}
],
"techniques": [
{
"id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
"name": {
"ar": "طباعة DTF",
"en": "DTF printing"
}
}
],
"zones": [
{
"id": "5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e",
"name": {
"ar": "الأمام",
"en": "Front"
}
},
{
"id": "6f8b0d2c-4e6a-4c8b-8d2f-3a5b7c9d1e3f",
"name": {
"ar": "الخلف",
"en": "Back"
}
}
],
"options": [
{
"technique_id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
"zone_ids": [
"5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e"
],
"cost": {
"net": "45.00",
"vat": "0.00",
"gross": "45.00",
"currency": "SAR"
},
"minimum_selling_price": {
"amount": "59.00",
"currency": "SAR"
}
},
{
"technique_id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
"zone_ids": [
"5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e",
"6f8b0d2c-4e6a-4c8b-8d2f-3a5b7c9d1e3f"
],
"cost": {
"net": "60.00",
"vat": "0.00",
"gross": "60.00",
"currency": "SAR"
},
"minimum_selling_price": {
"amount": "78.00",
"currency": "SAR"
}
}
],
"updated_at": "2026-11-18T09:12:44.512Z"
}Paging
Each page holds data and next_cursor. Send next_cursor back as cursor for the next page; it is null on the last one. A page can hold fewer items than limit, even none, while more follow: stop only when next_cursor is null. A cursor is opaque: an edited or foreign one answers 400 invalid_request with the error code invalid_cursor.
let cursor = null;
do {
const query = new URLSearchParams({ limit: "100" });
if (cursor) query.set("cursor", cursor);
const res = await fetch(`https://api.b7r.app/v1/catalog/products?${query}`, {
headers: { Authorization: `Bearer ${process.env.B7R_API_KEY}` },
});
const page = await res.json();
for (const product of page.data) await saveProduct(product);
cursor = page.next_cursor;
} while (cursor);