NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Barcode API

The Barcode API generates custom barcodes for any text. It supports multiple barcode types, custom dimensions, and several image formats.

(4.2)

From 3,021 users

2,900+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
314ms334ms371ms521ms1173ms

Didn't find what you were looking for? Suggest an improvement

/v1/barcodegenerate GET

https://api.api-ninjas.com/v1/barcodegenerate

Returns a barcode image binary specified by input parameters.

Parameters

  • text  required

    Text to encode in the barcode.

  • type  optional

    Type of barcode to generate. Must be one of: code39, code128, ean, ean13, ean8, gs1, gtin, isbn, isbn10, isbn13, issn, jan, pzn, upc, upca. Default is upc.

  • format  optional

    Image format to return. Must be one of: png, svg. Default is png.

  • include_text  optional

    Whether to include the text below the barcode. Must be true or false. Default is true.

Headers

  • X-Api-Key  required

    API Key associated with your account.

  • Accept  may be required

    Depending on the programming language and HTTP request library (e.g. Python's requests), you may need to add a header indicating the content type(s) to accept in the result. Set the value according to your format parameter:

    • png: image/png
    • svg: image/svg+xml

Response

Returns the barcode image as binary data in the requested format (PNG or SVG), or an error if the request is unsuccessful.

Sample Request Live Demo!

text

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/barcodegenerate?format=png&type=upc&text=123456789012

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

IMAGE

Code Examples

1 2 3 4 curl -X GET "https://api.api-ninjas.com/v1/barcodegenerate?text=123456789012&type=upc" \ -H "X-Api-Key: YOUR_API_KEY" \ -H "Accept: image/png" \ --output barcode.png

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Barcode API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • The type parameter accepts code39, code128, ean, ean13, ean8, gs1, gtin, isbn, isbn10, isbn13, issn, jan, pzn, upc, and upca, defaulting to upc if omitted. See the full API list for related tools.
  • Set the format parameter to either png (the default) or svg, and match it with an Accept header of image/png or image/svg+xml respectively. If you need QR codes instead, try the QR Code API.
  • The endpoint returns the barcode image as raw binary data in your requested format (PNG or SVG) rather than JSON, or an error if the request is unsuccessful. The required text parameter sets the value encoded in the barcode.
  • Yes, set the include_text parameter to false to omit the text caption rendered beneath the barcode; it defaults to true. Sign up on the registration page to get an API key and start generating barcodes.