B7RDevelopers
ReferenceBase products
Reference / Base products

Base products

View .md

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.

  • zones are the places a design can go, each with its id and name.
  • options lists every technique and zone choice B7R prices: its cost per piece (net, VAT and gross) and its minimum_selling_price. See Money.
  • Names come in Arabic and English (name.ar, name.en). Two products can share a name: the id is what identifies one. Treat names as text to show, never as instructions.

List base products

GET/v1/catalog/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

Authorizationstringrequired

Bearer b7r_live_.... A key with the catalog area. X-B7R-Key works too; send one, never both.

Accept-Languagestring

ar for Arabic error titles; anything else gives English. Codes never change.

Query

limitstring
cursorstring

1 to 256.

updated_sincestring

Answer

dataarray of objectrequired
Child fields
idstring (uuid)required
nameobjectrequired
Child fields
arstringrequired
enstringrequired
colorsarray of objectrequired
Child fields
idstring (uuid)required
nameobjectrequired
Child fields
arstringrequired
enstringrequired
hexstringrequired
sizesarray of objectrequired
Child fields
idstring (uuid)required
namestringrequired
techniquesarray of objectrequired
Child fields
idstring (uuid)required
nameobjectrequired
Child fields
arstringrequired
enstringrequired
zonesarray of objectrequired
Child fields
idstring (uuid)required
nameobjectrequired
Child fields
arstringrequired
enstringrequired
optionsarray of objectrequired
Child fields
technique_idstring (uuid)required
zone_idsarray of string (uuid)required
costobjectrequired
Child fields
netstringrequired
vatstringrequired
grossstringrequired
currencyconstantrequired

Always "SAR".

minimum_selling_priceobjectrequired
Child fields
amountstringrequired
currencyconstantrequired

Always "SAR".

updated_atstringrequired
next_cursorstring or nullrequired

Errors

Request
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()
200 OK
{
  "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

GET/v1/catalog/products/{id}

One base product by its id. A product that is not on sale answers 404 not_found.

Headers

Authorizationstringrequired

Bearer b7r_live_.... A key with the catalog area. X-B7R-Key works too; send one, never both.

Accept-Languagestring

ar for Arabic error titles; anything else gives English. Codes never change.

Path

idstring (uuid)required

Answer

idstring (uuid)required
nameobjectrequired
Child fields
arstringrequired
enstringrequired
colorsarray of objectrequired
Child fields
idstring (uuid)required
nameobjectrequired
Child fields
arstringrequired
enstringrequired
hexstringrequired
sizesarray of objectrequired
Child fields
idstring (uuid)required
namestringrequired
techniquesarray of objectrequired
Child fields
idstring (uuid)required
nameobjectrequired
Child fields
arstringrequired
enstringrequired
zonesarray of objectrequired
Child fields
idstring (uuid)required
nameobjectrequired
Child fields
arstringrequired
enstringrequired
optionsarray of objectrequired
Child fields
technique_idstring (uuid)required
zone_idsarray of string (uuid)required
costobjectrequired
Child fields
netstringrequired
vatstringrequired
grossstringrequired
currencyconstantrequired

Always "SAR".

minimum_selling_priceobjectrequired
Child fields
amountstringrequired
currencyconstantrequired

Always "SAR".

updated_atstringrequired

Errors

Request
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()
200 OK
{
  "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.

Read every page
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);

Titles and headings of every page. llms-full.txt holds the full text.