This endpoint allows users to obtain the associated bank and account details from the DICT PIX key.
DICT Key Types and Requirements
The DICT Key must be one of the following valid types: CNPJ, CPF, email, phone number, or UUID version 4. Each type has specific formatting and validation rules as outlined below.
| Key Type | Requirement | Validation Pattern |
|---|---|---|
| CNPJ | No formatting; must contain 14 characters | 14 numeric characters only |
| CPF | No formatting; must contain 11 characters | 11 numeric characters only |
| Must be a valid email format | Standard email validation | |
| Cellphone | Must follow international format with '+' prefix | ^\+[1-9]\d{1,14}$ |
| UUID v4 | Must be a valid UUID version 4 | Standard UUID v4 validation |
Protection Feature
If an invalid DICT Key is submitted, it will automatically be added to a blacklist for a duration of one hour.
Cache Mechanism
To avoid potential blocks from the BACEN DICT Control, the system caches bank account data for 6 hours after the initial lookup.
Please Note
When performing a lookup using the DICT Key, a BACEN DICT Control token will be consumed, and it's crucial to follow through with the transfer using the same DICT Key to restore its token.
For more information on how BACEN DICT Control works, please visit the following: https://www.bcb.gov.br/content/estabilidadefinanceira/pix/API-DICT.html#section/Seguranca/Limitacao-de-requisicoes