> For the complete documentation index, see [llms.txt](https://docs.maibmerchants.md/mia-qr-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maibmerchants.md/mia-qr-api/en/endpoints/information-retrieval-get/display-list-of-qr-codes-with-filtering-options.md).

# Display List of QR Codes with Filtering Options

**GET**`/v2/mia/qr`

This endpoint allows retrieving a list of QR codes created in the MIA platform, with the ability to apply various filtering, sorting, and pagination parameters.

***

#### Request parameters (query)

| Name          | Type              | Required | Description                                                                                                                         |
| ------------- | ----------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| count         | integer           | Yes      | Number of returned results.                                                                                                         |
| offset        | integer           | Yes      | Starting index for the result set.                                                                                                  |
| sortBy        | string (enum)     | No       | Field used for sorting. Possible values: `orderId`, `type`, `amountType`, `status`, `createdAt`, `expiresAt`. Default: `createdAt`. |
| order         | string (enum)     | No       | Sorting order. Possible values: `asc`, `desc`. Default: `asc`.                                                                      |
| qrId          | string (GUID)     | No       | Filter by QR ID.                                                                                                                    |
| extensionId   | string (GUID)     | No       | Filter by QR extension ID.                                                                                                          |
| orderId       | string (max. 100) | No       | Filter by merchant order ID.                                                                                                        |
| type          | string (enum)     | No       | QR type. Possible values: `Static`, `Dynamic`, `Hybrid`.                                                                            |
| amountType    | string (enum)     | No       | Amount type. Possible values: `Fixed`, `Controlled`, `Free`.                                                                        |
| amountFrom    | number (decimal)  | No       | Minimum amount value.                                                                                                               |
| amountTo      | number (decimal)  | No       | Maximum amount value.                                                                                                               |
| description   | string (max. 500) | No       | Filter by description.                                                                                                              |
| status        | string (enum)     | No       | QR status. Possible values: `Active`, `Inactive`, `Expired`, `Paid`, `Cancelled`.                                                   |
| createdAtFrom | string (datetime) | No       | Creation date — from. ISO 8601 format.                                                                                              |
| createdAtTo   | string (datetime) | No       | Creation date — to. ISO 8601 format.                                                                                                |
| expiresAtFrom | string (datetime) | No       | Expiration date — from. ISO 8601 format.                                                                                            |
| expiresAtTo   | string (datetime) | No       | Expiration date — to. ISO 8601 format.                                                                                              |
| terminalId    | string (max. 100) | No       | Terminal ID, provided by the bank.                                                                                                  |

***

#### Request example

```bash
curl -G "https://api.example.com/v2/mia/qr" \
  -H "Authorization: Bearer {{access_token}}" \
  --data-urlencode "count=10" \
  --data-urlencode "offset=0" \
  --data-urlencode "amountFrom=10.00" \
  --data-urlencode "amountTo=100.00" \
  --data-urlencode "sortBy=createdAt" \
  --data-urlencode "order=desc"
```

***

#### Response parameters

**Object `result`**

| Name       | Type    | Description                                          |
| ---------- | ------- | ---------------------------------------------------- |
| totalCount | integer | Total number of QR codes found based on the filters. |
| items      | array   | List of QR objects.                                  |

**Objects in `items`**

| Field       | Type               | Description                                                      |
| ----------- | ------------------ | ---------------------------------------------------------------- |
| qrId        | string (GUID)      | Unique identifier of the QR code.                                |
| extensionId | string (GUID)      | QR extension ID.                                                 |
| orderId     | string (max. 100)  | Merchant's order ID.                                             |
| type        | string (enum)      | QR type: `Static`, `Dynamic`, `Hybrid`.                          |
| url         | string (max. 1000) | QR URL. Format: HTTPS.                                           |
| amountType  | string (enum)      | Amount type: `Fixed`, `Controlled`, `Free`.                      |
| amount      | number (decimal)   | Fixed amount (if applicable).                                    |
| amountMin   | number (decimal)   | Minimum amount (for controlled amounts).                         |
| amountMax   | number (decimal)   | Maximum amount (for controlled amounts).                         |
| currency    | string (enum)      | Currency. ISO 4217 format.                                       |
| description | string (max. 500)  | QR description.                                                  |
| callbackUrl | string (max. 1000) | Callback URL.                                                    |
| status      | string (enum)      | QR status: `Active`, `Inactive`, `Expired`, `Paid`, `Cancelled`. |
| createdAt   | string (datetime)  | QR creation date. ISO 8601 format.                               |
| updatedAt   | string (datetime)  | Last update. ISO 8601 format.                                    |
| expiresAt   | string (datetime)  | QR expiration date. ISO 8601 format.                             |
| terminalId  | string (max. 100)  | Bank terminal ID.                                                |

**Other fields**

| Field               | Type    | Description                                       |
| ------------------- | ------- | ------------------------------------------------- |
| ok                  | boolean | `true` if the request was successfully processed. |
| errors              | object  | Error details, if any.                            |
| errors.errorCode    | string  | Error code.                                       |
| errors.errorMessage | string  | Error description.                                |

***

#### Exemplu răspuns

```json
{
  "result": {
    "totalCount": 42,
    "items": [
      {
        "qrId": "123e4567-e89b-12d3-a456-426614174000",
        "extensionId": "40e6ba44-7dff-48cc-91ec-386a38318c68",
        "type": "Dynamic",
        "url": "https://example.com/qr/123e4567-e89b-12d3-a456-426614174000",
        "amountType": "Fixed",
        "amount": 50.00,
        "currency": "MDL",
        "description": "Description",
        "status": "Paid",
        "createdAt": "2024-08-05T10:32:28+03:00",
        "updatedAt": "2024-08-05T10:33:50+03:00",
        "expiresAt": "2024-08-05T10:34:28+03:00",
        "terminalId": "P011111"
      }
    ]
  },
  "ok": true
}
```