Documentación de la API de códigos QR

Crear códigos QR

Crea un código QR dinámico para URLs y destinos gestionados, o un código QR estático para WiFi.

POST https://createqr.app/api/v1/create

Envía solo JSON. Para la autenticación por clave, el encabezado es la práctica recomendada. Los campos de clave en el cuerpo están ahí por compatibilidad con integraciones existentes.

Inicio rápido (cURL)

Este ejemplo de URL dinámica es la forma más rápida de empezar.

curl -sS -X POST 'https://createqr.app/api/v1/create' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ck_live_XXXXXXXXXXXXXXXXXXXXXXXX' \
  -d '{"data":"https://createqr.app","qrtype":"dynamic"}'

Autenticación y compatibilidad

Recomendado: Authorization: Bearer <key>
También se acepta: X-API-Key
Alternativa en JSON: apikey o api_key
Content-Type debe ser application/json
Los métodos que no sean POST devuelven 405 method_not_allowed

Parámetros principales

Parámetro	Tipo	Predeterminado	Descripción
`apikey`	String	`Obligatorio`	Clave secreta de API. Se recomienda usarla en el encabezado Authorization (Bearer). También se acepta apikey/api_key en el cuerpo JSON.
`data`	String	`Obligatorio`	Contenido que se va a codificar. El QR dinámico requiere una URL válida. El QR estático solo acepta cadenas WiFi.
`qrtype`	String	`dynamic`	Modo del QR: dynamic para URLs y destinos gestionados, o static solo para WiFi.
`title`	String	`Opcional`	Título del QR que se muestra en el panel (se recorta a 120 caracteres).
`folderid`	Number	`Opcional`	ID numérico entero positivo de una carpeta que pertenece a tu cuenta.

Parámetros de color y forma

Parámetro	Tipo	Predeterminado	Descripción
`transparent`	String/Bool	`off`	Se aceptan on/off, true/false, 1/0, yes/no.
`backcolor`	String	`#FFFFFF`	Color hexadecimal de fondo en formato #RRGGBB.
`frontcolor`	String	`#000000`	Color hexadecimal principal de los puntos en formato #RRGGBB.
`gradient`	String/Bool	`off`	Activa un degradado de dos colores en los puntos.
`radial`	String/Bool	`off`	Activa el degradado radial (funciona cuando gradient está activado).
`gradient_color`	String	`#15A97C`	Segundo color del degradado en #RRGGBB.
`marker_out_color`	String	`#000000`	Color del marco alrededor de los puntos de esquina in #RRGGBB format.
`marker_in_color`	String	`#000000`	Color de los puntos de esquina in #RRGGBB format.
`pattern`	String	`default`	Preajuste de estilo de los puntos del cuerpo. `default` `circle` `star` `diamond` `sparkle` `danger` `cross` `plus` `x` `heart` `shake` `blob` `special-circle-orizz` `special-circle-vert` `special-circle` `special-diamond` `ribbon` `oriental` `ellipse`
`marker`	String	`default`	Estilo del marco alrededor de los puntos de esquina. `corner_1` `corner_2` `corner_3` `corner_4` `corner_5` `corner_6` `corner_7` `corner_8`
`marker_in`	String	`default`	Tipo de puntos de esquina. `corner_in_1` `corner_in_2` `corner_in_3` `corner_in_4` `corner_in_5` `corner_in_6` `corner_in_7` `corner_in_8`
`optionlogo`	String	`none`	none, ruta recomendada a una marca de agua SVG local, ruta heredada a un PNG local o datos de imagen en base64. `none` `/images/watermarks/v2/01-link.svg` `/images/watermarks/v2/02-location.svg` `/images/watermarks/v2/03-email.svg` `/images/watermarks/v2/04-whatsapp.svg` `/images/watermarks/v2/05-wifi.svg` `/images/watermarks/v2/06-vcard.svg` `/images/watermarks/v2/07-menu.svg` `/images/watermarks/v2/08-app.svg` `/images/watermarks/v2/09-video.svg` `/images/watermarks/v2/10-feedback.svg` `/images/watermarks/v2/11-event.svg` `/images/watermarks/v2/12-coupon.svg` `/images/watermarks/v2/13-music.svg` `/images/watermarks/v2/14-social.svg` `/images/watermarks/v2/15-paypal.svg` `/images/watermarks/v2/16-bitcoin.svg` `/images/watermarks/v2/17-scan.svg` `data:image/*;base64,...`
`no_logo_bg`	String/Bool	`on`	Elimina la placa de fondo del logo.

Parámetros del marco

Parámetro	Tipo	Predeterminado	Descripción
`outer_frame`	String	`none`	Preajuste de estilo del marco. `none` `svg_frame_01` `svg_frame_02` `svg_frame_03` `svg_frame_04` `svg_frame_05` `svg_frame_06` `svg_frame_07` `svg_frame_08` `svg_frame_09` `svg_frame_10` `svg_frame_11` `svg_frame_12` `svg_frame_13` `svg_frame_14` `svg_frame_15` `svg_frame_16` `svg_frame_19` `svg_frame_22` `svg_frame_23` `svg_frame_26` `svg_frame_27` `svg_frame_28` `svg_frame_29` `svg_frame_30` `svg_frame_31` `svg_frame_33` `svg_frame_34` `svg_frame_35` `svg_frame_36` `svg_frame_38` `svg_frame_42` `caption_only_v1` `classic_thin_outline_v1` `classic_rounded_outline_v1` `classic_bottom_bar_v1` `classic_top_bar_v1` `classic_corner_brackets_v1` `classic_speech_bubble_v1` `colorful_blue_panel_v1` `colorful_teal_accents_v1` `colorful_coral_accents_v1` `colorful_botanical_v1` `colorful_celebration_v1` `colorful_cafe_v1` `illustrated_circle_v1` `illustrated_brackets_bottom_v1` `illustrated_speech_label_v1` `illustrated_brackets_top_v1` `illustrated_banner_filled_v1` `illustrated_banner_outline_v1` `illustrated_cloche_v1` `illustrated_beer_v1` `illustrated_chef_v1` `illustrated_shop_v1` `illustrated_drink_v1` `illustrated_coffee_v1` `illustrated_receipt_v1` `illustrated_arrow_v1` `illustrated_gift_v1` `illustrated_cinema_v1` `colorful_womens_day_mimosa_v1` `colorful_womens_day_venus_blossom_v1` `colorful_womens_day_ribbon_v1` `colorful_womens_day_floral_portrait_v1` `colorful_womens_day_tulip_garden_v1` `colorful_halloween_pumpkin_v1` `colorful_halloween_friendly_ghost_v1` `colorful_halloween_witch_hat_v1` `colorful_halloween_bat_moon_v1` `colorful_halloween_haunted_house_v1` `colorful_tequila_day_agave_v1` `colorful_tequila_day_margarita_v1` `colorful_tequila_day_bottle_v1` `colorful_tequila_day_lime_sun_v1` `colorful_tequila_day_desert_cactus_v1` `colorful_new_year_fireworks_v1` `colorful_new_year_champagne_v1` `colorful_new_year_midnight_clock_v1` `colorful_new_year_party_hat_v1` `colorful_new_year_disco_ball_v1` `colorful_valentines_heart_wings_v1` `colorful_valentines_love_letter_v1` `colorful_valentines_swan_pair_v1` `colorful_valentines_heart_lock_v1` `colorful_valentines_rose_v1` `colorful_easter_painted_egg_v1` `colorful_easter_spring_bunny_v1` `colorful_easter_egg_basket_v1` `colorful_easter_hatching_chick_v1` `colorful_easter_spring_wreath_v1` `colorful_april_fools_jester_v1` `colorful_april_fools_jack_in_box_v1` `colorful_april_fools_moustache_glasses_v1` `colorful_april_fools_comedy_mask_v1` `colorful_april_fools_pop_up_flower_v1` `colorful_eid_crescent_lantern_v1` `colorful_eid_dates_v1` `colorful_eid_star_medallion_v1` `colorful_eid_mosque_v1` `colorful_eid_festival_garland_v1` `colorful_labor_day_hard_hat_v1` `colorful_labor_day_crossed_tools_v1` `colorful_labor_day_handshake_v1` `colorful_labor_day_gear_v1` `colorful_labor_day_raised_fist_v1` `colorful_islamic_mihrab_v1` `colorful_islamic_open_book_v1` `colorful_islamic_prayer_beads_v1` `colorful_islamic_pierced_lantern_v1` `colorful_islamic_minarets_v1` `colorful_songkran_water_bowl_v1` `colorful_songkran_elephant_v1` `colorful_songkran_jasmine_garland_v1` `colorful_songkran_water_splash_v1` `colorful_songkran_temple_roof_v1` `colorful_fathers_day_tie_v1` `colorful_fathers_day_bow_tie_v1` `colorful_fathers_day_fishing_v1` `colorful_fathers_day_grill_v1` `colorful_fathers_day_trophy_v1` `colorful_pancasila_golden_star_v1` `colorful_pancasila_unity_chain_v1` `colorful_pancasila_banyan_v1` `colorful_pancasila_bull_v1` `colorful_pancasila_rice_cotton_v1` `colorful_indonesia_independence_red_white_ribbons_v1` `colorful_indonesia_independence_monas_v1` `colorful_indonesia_independence_bunting_v1` `colorful_indonesia_independence_rosette_v1` `colorful_indonesia_independence_bamboo_v1` `colorful_hung_kings_bronze_drum_v1` `colorful_hung_kings_lotus_v1` `colorful_hung_kings_temple_gate_v1` `colorful_hung_kings_sacred_mountains_v1` `colorful_hung_kings_rice_offerings_v1` `colorful_harvest_golden_wheat_v1` `colorful_harvest_cornucopia_v1` `colorful_harvest_orchard_basket_v1` `colorful_harvest_sweetcorn_v1` `colorful_harvest_field_sunrise_v1` `colorful_thanksgiving_turkey_v1` `colorful_thanksgiving_orchard_pie_v1` `colorful_thanksgiving_oak_acorns_v1` `colorful_thanksgiving_autumn_wreath_v1` `colorful_thanksgiving_candle_table_v1` `colorful_carnival_feather_mask_v1` `colorful_carnival_jester_v1` `colorful_carnival_festival_fan_v1` `colorful_carnival_parade_drum_v1` `colorful_carnival_confetti_v1` `colorful_holi_powder_burst_v1` `colorful_holi_gulal_bowls_v1` `colorful_holi_rangoli_v1` `colorful_holi_water_colours_v1` `colorful_holi_petal_rain_v1` `colorful_columbus_day_tall_ship_v1` `colorful_columbus_day_compass_rose_v1` `colorful_columbus_day_sea_chart_v1` `colorful_columbus_day_sextant_v1` `colorful_columbus_day_three_sails_v1` `colorful_christmas_fir_tree_v1` `colorful_christmas_baubles_v1` `colorful_christmas_holly_wreath_v1` `colorful_christmas_gingerbread_v1` `colorful_christmas_snowy_cottage_v1` `colorful_chinese_new_year_lanterns_v1` `colorful_chinese_new_year_dragon_v1` `colorful_chinese_new_year_lion_dance_v1` `colorful_chinese_new_year_plum_blossoms_v1` `colorful_chinese_new_year_gold_ingots_v1` `colorful_vietnamese_new_year_apricot_blossoms_v1` `colorful_vietnamese_new_year_banh_chung_v1` `colorful_vietnamese_new_year_spring_bouquet_v1` `colorful_vietnamese_new_year_lucky_envelopes_v1` `colorful_vietnamese_new_year_kumquat_v1` `colorful_food_drink_plate_v1` `colorful_food_drink_cloche_v1` `colorful_food_drink_takeaway_coffee_v1` `colorful_food_drink_mug_v1` `colorful_food_drink_menu_v1` `colorful_travel_suitcase_v1` `colorful_travel_backpack_v1` `colorful_travel_luggage_v1` `colorful_travel_balloon_v1` `colorful_travel_location_v1` `colorful_shopping_bag_v1` `colorful_shopping_cart_v1` `colorful_shopping_gift_v1` `colorful_shopping_storefront_v1` `colorful_shopping_delivery_truck_v1` `colorful_technology_cloud_v1` `colorful_technology_atom_v1` `colorful_technology_phone_hand_v1` `colorful_technology_monitor_v1` `colorful_technology_chat_v1` `colorful_wellness_medicine_v1` `colorful_wellness_medical_bag_v1` `colorful_wellness_care_hands_v1` `colorful_wellness_wellness_leaves_v1` `colorful_wellness_health_pulse_v1` `colorful_celebration_teddy_bear_v1` `colorful_celebration_bunting_v1` `colorful_celebration_balloons_v1` `colorful_celebration_ribbon_v1` `colorful_celebration_cake_v1` `colorful_creative_stationery_v1` `colorful_creative_artist_palette_v1` `colorful_creative_camera_v1` `colorful_creative_music_v1` `colorful_creative_book_v1`
`framelabel`	String	`SCAN ME`	Texto de la etiqueta del marco (se recorta a 80 caracteres).
`label_font`	String	`Arial, Helvetica, sans-serif`	Pila de fuentes para la etiqueta del marco.
`custom_frame_color`	String/Bool	`off`	Activa un color personalizado para el marco.
`framecolor`	String	`#000000`	Color hexadecimal del marco en formato #RRGGBB.

Ejemplos de solicitudes de creación

Ejemplo: QR simple

No-frills, fast scan

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app",
    "qrtype": "dynamic",
    "title": "Launch Landing QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#000000",
    "marker_out_color": "#000000",
    "marker_in_color": "#000000",
    "pattern": "default",
    "marker": "corner_1",
    "marker_in": "corner_in_1",
    "optionlogo": "none"
}

Request Outcome

Ejemplo: QR WiFi estático

Built for distance

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "WIFI:T:WPA;S:CreateQR Guest;P:guest-2026;H:false;;",
    "qrtype": "static",
    "title": "Guest Wi-Fi QR",
    "transparent": "off",
    "backcolor": "#0B1220",
    "frontcolor": "#FFFFFF",
    "marker_out_color": "#F4C84A",
    "marker_in_color": "#F4C84A",
    "pattern": "circle",
    "marker": "corner_3",
    "marker_in": "corner_in_3",
    "optionlogo": "none"
}

Request Outcome

Brand Color

Theme-aligned campaign

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app/pricing",
    "qrtype": "dynamic",
    "title": "Pricing QR",
    "transparent": "off",
    "backcolor": "#EAF4FF",
    "frontcolor": "#033895",
    "marker_out_color": "#15A97C",
    "marker_in_color": "#15A97C",
    "pattern": "special-circle-orizz",
    "marker": "corner_4",
    "marker_in": "corner_in_4",
    "optionlogo": "none"
}

Request Outcome

Ejemplo: Color + Logo

Preset watermark icon

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app/features",
    "qrtype": "dynamic",
    "title": "Feature Tour QR",
    "transparent": "off",
    "backcolor": "#033895",
    "frontcolor": "#FFFFFF",
    "marker_out_color": "#669DF4",
    "marker_in_color": "#669DF4",
    "pattern": "ribbon",
    "marker": "corner_5",
    "marker_in": "corner_in_5",
    "optionlogo": "/images/watermarks/v2/01-link.svg"
}

Request Outcome

Ejemplo: QR de campaña con marco

Poster-ready "SCAN ME"

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app/pricing",
    "qrtype": "dynamic",
    "title": "Pricing Poster QR",
    "transparent": "off",
    "frontcolor": "#2B0011",
    "marker_out_color": "#3B0001",
    "marker_in_color": "#3B0001",
    "pattern": "ellipse",
    "marker": "corner_8",
    "marker_in": "corner_in_7",
    "optionlogo": "none",
    "outer_frame": "balloon-top",
    "framelabel": "SCAN ME",
    "label_font": "Arial, Helvetica, sans-serif",
    "custom_frame_color": "on",
    "framecolor": "#3B0001"
}

Request Outcome

Gradient Mood

Extra style for socials

Request Method:

POST

Request URL:

https://createqr.app/api/v1/create

Request Parameters:

All parameters need to be sent as a JSON object in the request body.

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "data": "https://createqr.app/why-us",
    "qrtype": "dynamic",
    "title": "Brand Story QR",
    "transparent": "off",
    "backcolor": "#FFFFFF",
    "frontcolor": "#4B1EFF",
    "gradient": "on",
    "radial": "off",
    "gradient_color": "#FF7A00",
    "marker_out_color": "#101828",
    "marker_in_color": "#101828",
    "pattern": "special-diamond",
    "marker": "corner_6",
    "marker_in": "corner_in_8",
    "optionlogo": "none"
}

Request Outcome

Estructura de respuesta exitosa

{
    "success": true,
    "data": {
        "qrid": "1284",
        "svg": "<svg ...>...</svg>",
        "type": "dynamic",
        "title": "Launch Landing QR",
        "dashboard_url": "https://createqr.app/app/qrs/1284",
        "download_url": "https://createqr.app/app/qrs/1284/download/svg"
    },
    "request_id": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

Eliminar códigos QR

Elimina un QR por ID (solo el propietario).

POST https://createqr.app/api/v1/delete

Cuerpo de la solicitud

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "qrid": "1284"
}

Respuesta

{
    "success": true,
    "data": {
        "deleted": true,
        "qrid": "1284"
    },
    "request_id": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

Listar códigos QR

Lista tus QR en páginas de 100, primero los más recientes.

POST https://createqr.app/api/v1/list

Usa paginación a partir de 1. Los resultados devuelven hasta 100 elementos por página.

Cuerpo de la solicitud

{
    "apikey": "ck_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "pagination": "1"
}

Respuesta

{
    "success": true,
    "data": {
        "pagination": "1",
        "page_size": 100,
        "total": 2,
        "items": [
            {
                "qrid": "1284",
                "title": "Campaign QR",
                "type": "dynamic",
                "created_at": "2026-02-17 09:12:30",
                "short_url": "https://createqr.app/r/a1b2c3",
                "dashboard_url": "https://createqr.app/app/qrs/1284"
            },
            {
                "qrid": "1269",
                "title": "Guest Wi-Fi QR",
                "type": "static",
                "created_at": "2026-02-17 08:02:08",
                "dashboard_url": "https://createqr.app/app/qrs/1269"
            }
        ]
    },
    "request_id": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

Respuestas de error, límites y reintentos

Cada respuesta incluye request_id. Consérvalo al contactar con soporte para que podamos depurar rápidamente.

Estructura típica de error

{
    "success": false,
    "error": {
        "code": "validation_error",
        "message": "Static QR is only available for WiFi payloads."
    },
    "request_id": "5f5fbd38-f82f-49ad-bf11-f7f04ca9747a"
}

Estrategia de reintento

429 rate_limited: reintenta con retroceso exponencial más jitter.
Respeta Retry-After cuando esté presente.
429 monthly_quota_exceeded: espera a que se restablezca la cuota o usa una clave con cuota disponible.
5xx: reintenta con un número limitado de intentos y luego alerta a tu equipo.

Código de error	HTTP	Cuándo ocurre	Qué hacer
`invalid_api_key`	401	Clave de API ausente o no válida	Proporciona una clave válida mediante Bearer, X-API-Key o el campo del cuerpo JSON.
`invalid_content_type`	415	El cuerpo no es application/json	Envía Content-Type: application/json.
`request_too_large`	413	La carga útil supera el límite configurado	Reduce el tamaño del cuerpo, especialmente los logos en base64.
`plan_upgrade_required`	403	El plan no permite usar la API	Actualiza a Business desde Facturación.
`validation_error`	422	Campos no válidos como URL, payload estático, color o folderid	Usa dynamic para URLs y destinos gestionados; usa static solo para WiFi.
`rate_limited`	429	Se alcanzó el límite por minuto	Reintenta con retroceso exponencial y respeta Retry-After.
`monthly_quota_exceeded`	429	Cuota mensual agotada	Espera al restablecimiento o ajusta la cuota y la configuración de la clave.
`qr_not_found`	404	El objetivo de eliminación no existe o no te pertenece	Verifica la propiedad de qrid y vuelve a intentarlo.
`internal_error`	500	Problema inesperado del lado del servidor	Reintenta con retroceso y conserva request_id para soporte.

Preguntas frecuentes

Respuestas breves a las preguntas que más vemos en las integraciones.

¿Cuántas solicitudes de API puedo ejecutar?

La API está disponible solo para Business. La cuota mensual depende de tu plan activo y de las anulaciones de clave. La base predeterminada de Business es alta, y los administradores pueden ajustarla por clave.

¿Puedo enviar claves de API en el cuerpo JSON?

Sí. Se recomienda la autenticación basada en encabezados, pero también se aceptan los campos de compatibilidad del cuerpo apikey o api_key.

¿Puedo crear códigos QR estáticos con la API?

Sí, pero el modo estático se limita a cadenas WiFi. Usa el modo dinámico para URLs, PDFs, menús, apps, páginas sociales y otros destinos gestionados.

¿Los QR creados con la API aparecen en mi panel?

Sí. Cada creación correcta se guarda en tu cuenta y puede gestionarse como cualquier otro QR.

¿Qué pasa cuando alcanzo los límites?

Recibirás errores JSON. En las respuestas 429, respeta Retry-After y usa retroceso exponencial con jitter.

¿Puedo eliminar un QR de otra cuenta?

No. Las acciones de eliminar y listar están limitadas al propietario autenticado de la clave de API.

Buenas prácticas de seguridad

Nunca expongas claves API sin procesar en JavaScript del navegador, paquetes móviles o repositorios públicos.
Usa listas de IP permitidas para claves API para limitar el uso a servidores de confianza.
Registra request_id junto con tus propios ID de seguimiento para agilizar la gestión de incidentes.
Rota las claves periódicamente y de inmediato después de cualquier filtración de credenciales.

Abrir administrador de claves API

Automatiza la creación de códigos QR dinámicos con la API de CreateQR

Inicio rápido (cURL)

Autenticación y compatibilidad

Parámetros principales

Parámetros de color y forma

Parámetros del marco

Ejemplos de solicitudes de creación

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Request Method:

Request URL:

Request Parameters:

Request Outcome

Estructura de respuesta exitosa

Cuerpo de la solicitud

Respuesta

Cuerpo de la solicitud

Respuesta

Estructura típica de error

Estrategia de reintento

¿Cuántas solicitudes de API puedo ejecutar?

¿Puedo enviar claves de API en el cuerpo JSON?

¿Puedo crear códigos QR estáticos con la API?

¿Los QR creados con la API aparecen en mi panel?

¿Qué pasa cuando alcanzo los límites?

¿Puedo eliminar un QR de otra cuenta?

Buenas prácticas de seguridad