B7RDevelopers
v1The B7R API

Print and ship under your brand, straight from your code

Read the B7R catalog and price products with shipping from your website, your platform or an AI agent. B7R prints, packs and ships under your brand.

GET /v1/status
{
  "status": "ok",
  "api_enabled": true,
  "time": "2026-11-20T09:40:00.000Z"
}

No key needed: check the API yourself.

Try it

Each call only reads: nothing is saved and nothing is charged. The answers show sample values.

GET /v1/me
curl https://api.b7r.app/v1/me \
  -H "Authorization: Bearer $B7R_API_KEY"
const res = await fetch("https://api.b7r.app/v1/me", {
  headers: {
    Authorization: `Bearer ${process.env.B7R_API_KEY}`,
  },
});
const data = await res.json();
import os, requests

res = requests.get(
    "https://api.b7r.app/v1/me",
    headers={
        "Authorization": f"Bearer {os.environ['B7R_API_KEY']}",
    },
    timeout=30,
)
data = res.json()
Response
{
  "account": {
    "id": "a3f1c9e2-5b7d-4e8a-9c21-6d0f4b8e2a17",
    "store_name": "Sample Store",
    "verified": true,
    "active": true
  },
  "key": {
    "name": "Website",
    "prefix": "b7r_live_Q7m2Kx9P",
    "areas": [
      "catalog",
      "products:read",
      "products:write",
      "orders:read",
      "orders:write",
      "wallet:read"
    ],
    "expires_at": null
  },
  "limits": {
    "calls_per_minute": 120
  },
  "switches": {
    "api_enabled": true,
    "connection_enabled": true
  },
  "default_carrier": {
    "id": "9b1d3f5a-7c9e-4b1d-8f5a-6c8e0a2b4d6f",
    "name": {
      "ar": "شحن سريع",
      "en": "Express delivery"
    }
  }
}
GET /v1/catalog/products
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()
Response
{
  "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"
}
POST /v1/quote
curl -X POST https://api.b7r.app/v1/quote \
  -H "Authorization: Bearer $B7R_API_KEY" \
  -H "Idempotency-Key: $(uuidgen 2>/dev/null || node -e 'console.log(crypto.randomUUID())')" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "8c2e4f6a-1b3d-4a5c-8e7f-9a0b1c2d3e4f",
    "technique_id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
    "zone_ids": [
      "5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e"
    ],
    "quantity": 2,
    "carrier_id": "9b1d3f5a-7c9e-4b1d-8f5a-6c8e0a2b4d6f"
  }'
const res = await fetch("https://api.b7r.app/v1/quote", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.B7R_API_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "product_id": "8c2e4f6a-1b3d-4a5c-8e7f-9a0b1c2d3e4f",
    "technique_id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
    "zone_ids": [
      "5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e"
    ],
    "quantity": 2,
    "carrier_id": "9b1d3f5a-7c9e-4b1d-8f5a-6c8e0a2b4d6f"
  }),
});
const data = await res.json();
import os, requests, uuid

res = requests.post(
    "https://api.b7r.app/v1/quote",
    headers={
        "Authorization": f"Bearer {os.environ['B7R_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "product_id": "8c2e4f6a-1b3d-4a5c-8e7f-9a0b1c2d3e4f",
        "technique_id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
        "zone_ids": [
            "5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e"
        ],
        "quantity": 2,
        "carrier_id": "9b1d3f5a-7c9e-4b1d-8f5a-6c8e0a2b4d6f"
    },
    timeout=30,
)
data = res.json()
Response
{
  "product_id": "8c2e4f6a-1b3d-4a5c-8e7f-9a0b1c2d3e4f",
  "technique_id": "2b9d6e1f-7a4c-4d8e-b3f5-0c1a2e3d4f5a",
  "zone_ids": [
    "5e7a9c1b-3d5f-4b7a-9c1e-2f4a6b8c0d2e"
  ],
  "quantity": 2,
  "unit_cost": {
    "net": "45.00",
    "vat": "0.00",
    "gross": "45.00",
    "currency": "SAR"
  },
  "lines_total": {
    "net": "90.00",
    "vat": "0.00",
    "gross": "90.00",
    "currency": "SAR"
  },
  "shipping": {
    "carrier_id": "9b1d3f5a-7c9e-4b1d-8f5a-6c8e0a2b4d6f",
    "fee": {
      "net": "25.00",
      "vat": "0.00",
      "gross": "25.00",
      "currency": "SAR"
    }
  },
  "total": {
    "net": "115.00",
    "vat": "0.00",
    "gross": "115.00",
    "currency": "SAR"
  },
  "minimum_selling_price": {
    "amount": "59.00",
    "currency": "SAR"
  }
}
GET /v1/status
curl https://api.b7r.app/v1/status
const res = await fetch("https://api.b7r.app/v1/status");
const data = await res.json();
import requests

res = requests.get(
    "https://api.b7r.app/v1/status",
    timeout=30,
)
data = res.json()
Response
{
  "status": "ok",
  "api_enabled": true,
  "time": "2026-11-20T09:40:00.000Z"
}
For AI agents:/llms.txt/llms-full.txt/openapi.jsonand a .md copy of every page.

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