MEmeta
QR Code Collection

List All Message QR Codes

Retrieve all message QR codes for a phone number, sorted by creation time (newest first). Supports field selection, filtering by code, cursor-based pagination, and QR image generation.

get/{Version}/{Phone-Number-ID}/message_qrdls

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Phone-Number-ID}/message_qrdls
  • Auth
    HTTP bearer

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

Phone-Number-IDstring required

The WhatsApp Business Account phone number ID for which to list QR codes. This ID is provided when you add a phone number to your WhatsApp Business Account.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. Available fields:

  • code: QR code identifier (always included)
  • prefilled_message: Pre-filled message text (always included)
  • deep_link_url: WhatsApp deep link URL (always included)
  • creation_time: Unix timestamp when QR code was created (first-party apps only)
  • qr_image_url.format(FORMAT): QR code image URL where FORMAT is SVG or PNG

Example: "code,prefilled_message,qr_image_url.format(SVG)"

codestring

Filter results to a specific QR code by its unique identifier. When provided, only the matching QR code will be returned (if it exists).

limitinteger

Maximum number of QR codes to return in a single response. Default and maximum limit is typically 25.

afterstring

Cursor for pagination. Use this to get the next page of results. Obtain this value from the paging.cursors.after field in previous responses.

beforestring

Cursor for pagination. Use this to get the previous page of results. Obtain this value from the paging.cursors.before field in previous responses.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Response

Successfully retrieved the list of message QR codes

Example response

{
  "data": [
    {
      "code": "ANED2T5QRU7HG1",
      "prefilled_message": "Hi! I'm interested in your products. Can you help me?",
      "deep_link_url": "https://wa.me/message/ANED2T5QRU7HG1",
      "creation_time": 1672531200,
      "qr_image_url": "https://scontent-iad3-1.xx.fbcdn.net/m1/v/t6/An-H7T8OyTqO07lcRGHlKteuPMKDnx07nua3dGb4i560bVxDscweOV4KoKD_4wCDFoHR_C5LyVjxQISKPxwora1bbFhUEo2nA19ZPLBUVoQSmV12l1x-nuu312jKty-5rmojmde_a0g?ccb=10-5&oh=00_AfASq_vjojFza_9A-HDeRgHM3wZ8yjNprpYBjNKOn8RkSg&oe=64550A9E&_nc_sid=f36290"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MTYwNDYxNzIwMA==",
      "after": "MTYwNDYxNzIwMQ=="
    },
    "previous": "https://graph.facebook.com/v23.0/1234567890123456/message_qrdls?before=MTYwNDYxNzIwMA==",
    "next": "https://graph.facebook.com/v23.0/1234567890123456/message_qrdls?after=MTYwNDYxNzIwMQ=="
  }
}

Changes

No recorded changes to this operation across all 5 revisions of this API.