QR Code Generation

Programmatically generate high-quality QR codes with custom colors, styles, and embedded logos.

Prerequisites

To use the API, you must authenticate your requests using an API Key.

How to Authenticate

Create an API Key from your dashboard to authenticate your requests. Each API Key has specific scopes and environments (test/live).

Manage API Keys

Generate a QR Code

Send a POST request to generate a QR code. The response includes the image data (Base64) and a ready-to-use HTML embed code.

const FormData = require('form-data');
const fetch = require('node-fetch');

const form = new FormData();
form.append('text', 'https://example.com');
form.append('color', '#000000');
form.append('background_color', '#ffffff');
form.append('qr_type', 'circle__rounded');
form.append('image_type', 'link');
form.append('image', 'https://example.com/logo.png');

const response = await fetch('https://eaglebirth.com/api/app/qr_code_generator/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_EAGLEBIRTH_API_KEY',
    ...form.getHeaders()
  },
  body: form
});

const data = await response.json();
console.log(data);

Payload Parameters

Parameter	Required	Type	Description
text	Yes	string	The data to be encoded in the QR code (URL, text, etc.).
image	Optional	file \| string	A logo to embed in the center. Can be a file upload or a public URL string.
image_type	Optional	string	Set to 'link' if providing a URL, 'image' if uploading a file, or 'none'.
color	Optional	hex	Foreground color (e.g., #000000).
background_color	Optional	hex	Background color (e.g., #ffffff).
qr_type	Optional	string	Style of the QR patterns (e.g., 'circle__rounded', 'default'). See Supported QR Styles below.

Supported QR Styles

You can pass any of the following IDs to the qr_type parameter to customize the visual style of your code. Click on a style to copy its ID.

default_qr

Copy

circle__circle

Copy

circle__gapped_square

Copy

circle__horizontal

Copy

circle__rounded

Copy

circle__square

Copy

circle__vertical

Copy

custom_eye__circle

Copy

custom_eye__gapped_square

Copy

custom_eye__horizontal

Copy

custom_eye__rounded

Copy

custom_eye__square

Copy

custom_eye__vertical

Copy

gapped_square__circle

Copy

gapped_square__gapped_square

Copy

gapped_square__horizontal

Copy

gapped_square__rounded

Copy

gapped_square__square

Copy

gapped_square__vertical

Copy

gradiant_horizontal

Copy

gradiant_radial

Copy

gradiant_square

Copy

gradiant_vertical

Copy

horizontal__circle

Copy

horizontal__gapped_square

Copy

horizontal__horizontal

Copy

horizontal__rounded

Copy

horizontal__square

Copy

horizontal__vertical

Copy

rounded__circle

Copy

rounded__gapped_square

Copy

rounded__horizontal

Copy

rounded__rounded

Copy

rounded__square

Copy

rounded__vertical

Copy

square__circle

Copy

square__gapped_square

Copy

square__horizontal

Copy

square__rounded

Copy

square__vertical

Copy

vertical__circle

Copy

vertical__gapped_square

Copy

vertical__horizontal

Copy

vertical__rounded

Copy

vertical__square

Copy

vertical__vertical

Copy

Response Structure

The API returns a JSON object containing the status, the raw Base64 image data, and an HTML embed code string.

json

{
  "res": "success",
  "data": "data:image/png;base64,iVBORw0KGgo...",
  "embed_code": "<img src='https://assets.eaglebirth.com/qr/render/?token=...' alt='QR Code' width='250' />"
}

The Embed Code

The embed_code field provides a secure, signed HTML string you can place directly on your website. If you provide a logo URL, the embed code uses a dynamic link. If you upload a local image file, the embed code will contain the full image data (Data URI) to ensure it works instantly without hosting requirements.

Back to Documentation

QR Code Generation

Programmatically generate high-quality QR codes with custom colors, styles, and embedded logos.

Prerequisites

To use the API, you must authenticate your requests using an API Key.

How to Authenticate

Create an API Key from your dashboard to authenticate your requests. Each API Key has specific scopes and environments (test/live).

Manage API Keys

Generate a QR Code

Send a POST request to generate a QR code. The response includes the image data (Base64) and a ready-to-use HTML embed code.

const FormData = require('form-data');
const fetch = require('node-fetch');

const form = new FormData();
form.append('text', 'https://example.com');
form.append('color', '#000000');
form.append('background_color', '#ffffff');
form.append('qr_type', 'circle__rounded');
form.append('image_type', 'link');
form.append('image', 'https://example.com/logo.png');

const response = await fetch('https://eaglebirth.com/api/app/qr_code_generator/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_EAGLEBIRTH_API_KEY',
    ...form.getHeaders()
  },
  body: form
});

const data = await response.json();
console.log(data);

Payload Parameters

Parameter	Required	Type	Description
text	Yes	string	The data to be encoded in the QR code (URL, text, etc.).
image	Optional	file \| string	A logo to embed in the center. Can be a file upload or a public URL string.
image_type	Optional	string	Set to 'link' if providing a URL, 'image' if uploading a file, or 'none'.
color	Optional	hex	Foreground color (e.g., #000000).
background_color	Optional	hex	Background color (e.g., #ffffff).
qr_type	Optional	string	Style of the QR patterns (e.g., 'circle__rounded', 'default'). See Supported QR Styles below.

Supported QR Styles

You can pass any of the following IDs to the qr_type parameter to customize the visual style of your code. Click on a style to copy its ID.

default_qr

Copy

circle__circle

Copy

circle__gapped_square

Copy

circle__horizontal

Copy

circle__rounded

Copy

circle__square

Copy

circle__vertical

Copy

custom_eye__circle

Copy

custom_eye__gapped_square

Copy

custom_eye__horizontal

Copy

custom_eye__rounded

Copy

custom_eye__square

Copy

custom_eye__vertical

Copy

gapped_square__circle

Copy

gapped_square__gapped_square

Copy

gapped_square__horizontal

Copy

gapped_square__rounded

Copy

gapped_square__square

Copy

gapped_square__vertical

Copy

gradiant_horizontal

Copy

gradiant_radial

Copy

gradiant_square

Copy

gradiant_vertical

Copy

horizontal__circle

Copy

horizontal__gapped_square

Copy

horizontal__horizontal

Copy

horizontal__rounded

Copy

horizontal__square

Copy

horizontal__vertical

Copy

rounded__circle

Copy

rounded__gapped_square

Copy

rounded__horizontal

Copy

rounded__rounded

Copy

rounded__square

Copy

rounded__vertical

Copy

square__circle

Copy

square__gapped_square

Copy

square__horizontal

Copy

square__rounded

Copy

square__vertical

Copy

vertical__circle

Copy

vertical__gapped_square

Copy

vertical__horizontal

Copy

vertical__rounded

Copy

vertical__square

Copy

vertical__vertical

Copy

Response Structure

The API returns a JSON object containing the status, the raw Base64 image data, and an HTML embed code string.

json

{
  "res": "success",
  "data": "data:image/png;base64,iVBORw0KGgo...",
  "embed_code": "<img src='https://assets.eaglebirth.com/qr/render/?token=...' alt='QR Code' width='250' />"
}