GETTING STARTED

Start collecting verified reviews

From registration to your first review — in under 15 minutes.

Everything below works from both the web dashboard and the REST API. Choose whichever fits your workflow.

For Businesses

Register your business

Go to veribureau.com/dashboard and click Register. You will need your business name, email, industry, and country.

Or via API:

curl -X POST https://veribureau.net/api/v1/businesses/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Your Business Name",
    "slug": "your-business",
    "industry": "IT",
    "country": "US",
    "email": "contact@yourbusiness.com"
  }'

You will receive a 6-digit verification code by email.

curl -X POST https://veribureau.net/api/v1/businesses/verify-registration \
  -H "Content-Type: application/json" \
  -d '{"email": "contact@yourbusiness.com", "code": "123456"}'

Response:

{
  "id": "b19a3114-...",
  "name": "Your Business Name",
  "slug": "your-business",
  "apiKey": "vb_live_a1b2c3d4e5f6...",
  "message": "Save your API key. It will not be shown again."
}

Save your API key immediately. It is shown only once. If lost, you can recover it via email verification.

Send review links to customers

Option A: Auto-send (recommended) — VeriBureau generates a token, creates a review link, and emails your customer automatically.

curl -X POST https://veribureau.net/api/v1/tokens/send \
  -H "Content-Type: application/json" \
  -H "X-VB-API-Key: vb_live_your_key_here" \
  -d '{
    "customerEmail": "customer@example.com",
    "customerName": "John",
    "orderRef": "ORD-2026-001"
  }'

Response:

{
  "tokenId": "VB-M5X2K-A8B3CD",
  "sent": true,
  "reviewUrl": "https://veribureau.com/review?token=VB-M5X2K-A8B3CD"
}

Option B: Manual — Generate a token and send the link yourself (email, SMS, QR code, printed receipt).

curl -X POST https://veribureau.net/api/v1/tokens/generate \
  -H "Content-Type: application/json" \
  -H "X-VB-API-Key: vb_live_your_key_here" \
  -d '{"source": "API"}'

Response:

{
  "tokens": ["VB-M5X2K-A8B3CD"],
  "reviewUrls": ["https://veribureau.com/review?token=VB-M5X2K-A8B3CD"]
}

Option C: Batch — generate up to 100 tokens at once.

curl -X POST https://veribureau.net/api/v1/tokens/generate \
  -H "Content-Type: application/json" \
  -H "X-VB-API-Key: vb_live_your_key_here" \
  -d '{"count": 50, "source": "API"}'

Customer submits a verified review

Your customer clicks the review link, selects a score (1–100), optionally writes feedback, verifies their email with a one-time code, and submits. The Proof Token is sealed permanently.

You receive an email notification when a new review is published. You can respond to reviews from the dashboard or via API.

curl -X POST https://veribureau.net/api/v1/reviews/{reviewId}/respond \
  -H "Content-Type: application/json" \
  -H "X-VB-API-Key: vb_live_your_key_here" \
  -d '{"text": "Thank you for your feedback. We appreciate it."}'

Your Trust Score updates automatically

Your Composite Business Score (CBS) recalculates with every new review. It appears on your public profile, badge, and widget.

# Check your public profile
curl https://veribureau.net/api/v1/businesses/your-business

# Embed badge on your website
<a href="https://veribureau.com/biz/your-business">
  <img src="https://veribureau.net/api/v1/businesses/your-business/badge"
       alt="VeriBureau Trust Score" height="32" />
</a>

# Badge variants: ?size=micro|standard|detailed|banner&theme=light|dark

Embed the review widget

Add a live review widget to your website with one line of code.

<script src="https://veribureau.com/widget.js"
        data-slug="your-business"
        data-theme="light"></script>

The widget displays your Trust Score, trend, and latest reviews. Supports light and dark themes.

For Developers

Quick integration (Node.js)

// After a purchase/transaction in your system:
async function sendReviewRequest(customerEmail, customerName, orderId) {
  const response = await fetch("https://veribureau.net/api/v1/tokens/send", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-VB-API-Key": process.env.VERIBUREAU_API_KEY,
    },
    body: JSON.stringify({
      customerEmail,
      customerName,
      orderRef: orderId,
    }),
  });

  const data = await response.json();
  console.log("Review link sent:", data.reviewUrl);
  return data;
}

Quick integration (Python)

import requests
import os

def send_review_request(customer_email, customer_name, order_id):
    response = requests.post(
        "https://veribureau.net/api/v1/tokens/send",
        headers={
            "Content-Type": "application/json",
            "X-VB-API-Key": os.environ["VERIBUREAU_API_KEY"],
        },
        json={
            "customerEmail": customer_email,
            "customerName": customer_name,
            "orderRef": order_id,
        },
    )
    data = response.json()
    print(f"Review link sent: {data['reviewUrl']}")
    return data

Quick integration (PHP)

function sendReviewRequest($email, $name, $orderId) {
    $ch = curl_init("https://veribureau.net/api/v1/tokens/send");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            "Content-Type: application/json",
            "X-VB-API-Key: " . getenv("VERIBUREAU_API_KEY"),
        ],
        CURLOPT_POSTFIELDS => json_encode([
            "customerEmail" => $email,
            "customerName" => $name,
            "orderRef" => $orderId,
        ]),
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

Verify a token

curl https://veribureau.net/api/v1/tokens/VB-M5X2K-A8B3CD/verify

# Response (valid):
{"valid": true, "business": {"name": "...", "industry": "IT"}}

# Response (used):
{"valid": false, "reason": "Token already used"}

# Response (expired):
{"valid": false, "reason": "Token expired"}

Verify audit chain integrity

curl https://veribureau.net/api/v1/audit/verify

{
  "rootHash": "8b8c530b3ef2...",
  "totalRecords": 22,
  "valid": true,
  "axiom": "Every event is an immutable fact",
  "instruction": "Save this hash. If it ever changes retroactively, the chain has been tampered with."
}

Authentication

All authenticated endpoints require your API key in the X-VB-API-Key header. Public endpoints (profile, reviews, audit, stats) require no authentication.

Rate limits

API requests are rate-limited per endpoint and per IP address. Rate limit headers (X-RateLimit-Limit,X-RateLimit-Remaining) are included in every response.

Base URL

https://veribureau.net/api/v1

Full API documentation →

Integration Patterns

E-COMMERCE

After checkout

Call POST /tokens/send in your order confirmation webhook. The customer receives a review invitation alongside their order confirmation. Recommended delay: 3–7 days after delivery.

SAAS / SOFTWARE

After trial or milestone

Generate a token when a user completes their trial, reaches a usage milestone, or renews a subscription. Send the review link as part of your engagement flow.

PHYSICAL BUSINESS

QR codes

Generate tokens in batch. Print QR codes on receipts, packaging, or table cards. Each QR code links to a unique review page. Available via GET /tokens/:token/qr (SVG) or GET /tokens/:token/qr.png (PNG).

SERVICES / CONSULTING

After project completion

Send a review link when you deliver the final deliverable or close a support ticket. Include the project reference for context.

Next steps

API Documentation

Full endpoint reference with request/response examples

The Protocol

Three axioms explained in detail

Scoring Methodology

How Trust Scores are calculated

How It Works

Simple explanation — no technical background needed