canonical: https://jentic.com/apis/getdynamicqr.com/getdynamicqr

# Getdynamicqr D-QR REST API

The D-QR REST API creates and manages dynamic QR codes whose target you can change after the code is printed, and tracks every scan. An agent creates a QR code, updates where it points, renders it as an image with an embedded logo, and reads time-series scan analytics and paginated scan history. It also organises codes into folders, creates codes in bulk, builds link pages and digital business cards, and verifies custom domains for the short links. Responses are JSON, and API clients authenticate with an X-Client-ID header plus a bearer client secret.

## For AI agents

Create and manage dynamic QR codes whose targets you can change after printing, render them as images, and track scans with time-series analytics and scan history. Also builds link pages, folders, and business cards. Authenticates with an X-Client-ID header and a bearer client secret.

## Scope

Does not handle payment processing, email campaigns, or SMS delivery. Use for creating and tracking dynamic QR codes only.

## Capabilities

- Create a dynamic QR code whose target you can change after printing
- Render a QR code image as SVG with an embedded logo
- Read time-series scan analytics and paginated scan history for a QR code
- Organise QR codes into folders and move codes between them
- Create QR codes in bulk in a single request
- Build a link page and add or update its items
- Add and verify a custom domain for the short links

## Use cases

### Agent-Managed Dynamic QR Codes

An AI agent running a print or packaging campaign can call the D-QR REST API through Jentic to create a dynamic QR code, point it at a destination, and repoint it later without reprinting. The agent creates and updates the code and renders its image without the developer wiring the X-Client-ID and bearer auth by hand. Jentic returns the matching operation and its input schema so the agent manages the code inline.

Example prompt: Create a dynamic QR code pointing to a landing page, render its image, and later update the destination

### Campaign Scan Analytics

A dashboard can report how a campaign's codes are performing by reading each code's time-series scan analytics and its paginated scan history. D-QR returns scan counts over a chosen range and a per-scan history, so a workflow can show when and how often each code was scanned and spot the best-performing placements.

Example prompt: Pull a QR code's scan analytics over a date range and list its most recent scans

### Bulk QR Generation and Organisation

A team producing many codes at once can create them in bulk and sort them into folders rather than one at a time. D-QR creates QR codes in a single bulk request and moves codes into folders, so a workflow can generate a batch of codes for a product line and keep them grouped for reporting.

Example prompt: Create a batch of QR codes in bulk and move them all into a named folder

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/qrcodes` | Create a QR code |
| PATCH | `/qrcodes/{id}` | Update a QR code's target |
| GET | `/qrcodes/{id}/analytics` | Get time-series scan analytics |
| GET | `/qrcodes/{id}/scans` | Get paginated scan history |
| POST | `/qrcodes/render` | Render a QR code image |
| POST | `/qrcodes/bulk` | Create QR codes in bulk |
| POST | `/link-pages` | Create a link page |

## Key resources

- **QR Codes** — Create, read, update, delete, render, and bulk-create dynamic QR codes.
- **Analytics and Scans** — Read time-series scan analytics and paginated scan history for a QR code.
- **Folders** — Group QR codes into folders and move codes between them.
- **Link Pages and Business Cards** — Build link pages with items and create digital business cards.
- **Custom Domains** — Add, verify, and activate custom domains for the short links.

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 67 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 74 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 59 / 100
  - Agent Usability: 87 / 100
  - Security: 55 / 100
  - AI Discoverability: 73 / 100
- **View full report:** https://jentic.com/apis/getdynamicqr.com/getdynamicqr/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring D-QR by hand means supplying both its X-Client-ID header and a bearer client secret, handling plan feature flags that return a 403 on otherwise valid tokens, and staying within its request rate limits. Through Jentic you install once, import D-QR from the API Directory, store the credentials once, and your agent calls it.
- **Permission scoping:** D-QR puts the resource id in the URL path, so a rule can bound your agent to the QR operations it needs and even to one code. You choose which operations it may call, so the admin operations and destructive ones like deleting a QR code are not included unless you add them.
- **Credential handling:** Your D-QR client id and secret are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a dynamic QR code' or 'get QR scan analytics', and Jentic returns the matching D-QR operation with its input schema so the agent calls the right endpoint directly.

## Related APIs

- **LinQR** — Also generates branded QR codes for URL, contact, WiFi, and other payloads.
- **QR Code API** — Generates static QR code images in PNG, SVG, and other formats.
- **Bitly API** — Shortens URLs and reports per-link click analytics.

## FAQ

### What authentication does the D-QR REST API use?

The D-QR REST API authenticates API clients with an X-Client-ID header and a bearer client secret, while its mobile tokens use a bearer token alone, per its OpenAPI spec. Through Jentic the credentials are stored once, encrypted, by your own Jentic One instance and injected at call time, so they never reach the agent's prompt or logs.

### Is there a D-QR MCP server?

You don't need an MCP server to give your agent the D-QR REST API. Jentic connects it directly from the API Directory: import it, store your credentials once, and your agent can create and track QR codes straight away.

### Can I limit what my agent is allowed to do with the D-QR REST API?

Yes. Write a rule that allows just the QR operations your agent needs, such as creating codes, rendering them, and reading scan analytics, so it cannot reach the admin operations like changing a user's plan or delete a QR code. Every call it makes is logged.

### Can I change where a QR code points after it is printed with the D-QR REST API?

Yes. The codes are dynamic, so an agent updates a QR code to point at a new destination without reprinting it, and the code keeps accumulating scans against the same analytics record.

### What are the rate limits for the D-QR REST API?

Its OpenAPI spec states that authenticated endpoints allow 60 requests per minute keyed by client id, and the auth endpoints allow 10 per minute. Responses carry X-RateLimit headers and a 429 response includes a Retry-After value.

### How do I create a dynamic QR code with the D-QR REST API through Jentic?

Search Jentic for an intent like 'create a dynamic QR code' and it returns the D-QR create operation with its input schema, so your agent sends the destination and reads back the code and its image. To run it on your own infrastructure, install Jentic One from its GitHub repo.