List Static QR Codes

GET 
/pix/deposits/qr-codes/static

Retrieve all static QR Codes associated with the user.

Request

Query Parameters

page number

Default value: 1

Page number.

size number

Possible values: <= 100

Default value: 20

Page size. Max size is 100.

sort string

Possible values: [created_at]

Page sort attribute.

order string

Possible values: [asc, desc]

Default value: asc

Page order.

Header Parameters

nonce stringrequired

The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

x-lang string

Possible values: [pt-BR, en-US]

Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

x-product-uuid string

The product ID is a UUID (v4) used to identify the Z.ro product configuration.

x-product-target-user-uuid string

The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.

Responses

200

The static QR Codes returned successfully.

application/json

Schema

Schema

page numberrequired

Page number.

page_size numberrequired

Page size.

page_total numberrequired

Page total.

total numberrequired

Total of elements.

data object[]required
Static QR Code data.
Array [
id stringrequired
Static QR Code ID.
txid stringrequired
PIX txID.
emv string
EMV code.
key_id stringrequired
Associated key ID.
value number
Value in R$ cents.
summary string
User defined payment ID.
description string
User defined payment description.
expiration_date date-time
Expiration date to pay static QR Code. Max date is 3 months ahead.
payable_many_times boolean
If it is true, static QR Code can be paid many times. When it is false, expiration date is required.
state stringrequired
Possible values: [PENDING, READY, DELETING, DELETED, ERROR]
Static QR Code state.
created_at date-timerequired
Static QR Code created at.
]

Example (from schema)

{
  "page": 1,
  "page_size": 20,
  "page_total": 20,
  "total": 100,
  "data": [
    {
      "id": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "txid": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "emv": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "key_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
      "value": 1299,
      "summary": "party-payment",
      "description": "The party payment.",
      "expiration_date": "2025-06-21T06:49:55.300Z",
      "payable_many_times": true,
      "state": "PENDING",
      "created_at": "2025-06-21T06:49:55.300Z"
    }
  ]
}

400

If any required params are missing or has invalid format or type.

401

User authentication failed.

422

If any required params are missing or has invalid format or type.

Authorization: http

name: bearertype: httpscheme: bearerbearerFormat: JWT

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X GET 'https://docs.zrobank.io/pix/deposits/qr-codes/static' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Request Collapse all

Auth

Bearer Token

Parameters

nonce — headerrequired

page — query

size — query

sort — query

---created_at

order — query

---ascdesc

x-lang — header

---pt-BRen-US

x-product-uuid — header

x-product-target-user-uuid — header

ResponseClear

Click the Send API Request button above and see the response here!