Skip to main content

Authentication

The QR Build API uses API keys to authenticate requests.

Getting Your API Key​

  1. Log in to your QR Build dashboard
  2. Navigate to Settings > API Keys
  3. Click Create New API Key
  4. Give your key a descriptive name (e.g., "Production API Key")
  5. Copy the key immediately — you won't be able to see it again!
caution

Keep your API key secure! Never commit it to version control or expose it in client-side code.

API Key Format​

API keys follow this format:

PartDescription
qrb_live_Prefix indicating a live/production key
xxxxxxxx...32 random characters

Using Your API Key​

Include your API key in the X-API-Key header, or use the Authorization header with a Bearer token.

X-API-Key Header​

curl -X GET "https://integration-api.qr-build.com/qr-codes" \
  -H "X-API-Key: qrb_live_your_api_key_here"

Bearer Token​

curl -X GET "https://integration-api.qr-build.com/qr-codes" \
  -H "Authorization: Bearer qrb_live_your_api_key_here"

API Key Format​

qrb_live_xxxxxxxxxxxxxxxxxxxxxxxx

Security Best Practices​

  1. Use environment variables — Store your API key in environment variables, not in code
  2. Rotate keys regularly — Create new keys and revoke old ones periodically
  3. Use separate keys — Use different keys for different environments (development, staging, production)
  4. Monitor usage — Check your API key usage in the dashboard

Setup Examples​

const API_KEY = process.env.QR_BUILD_API_KEY;

const response = await fetch(
  "https://integration-api.qr-build.com/qr-codes",
  {
    headers: {
      "X-API-Key": API_KEY,
      "Content-Type": "application/json",
    },
  }
);