Skip to main content

Pix Keys listing for an Alias

Request

ENDPOINT
/account/ACCOUNT_KEY/alias/ALIAS_KEY/pix_key
METHOD
GET

Path Params

FieldTypeDescriptionCharacters
account_keystringUnique account key.36
alias_keystringUnique alias key.36
Pix Key Types

The “pix_key” is of the type Random Key (UUID4), following this format: Random Key: UUID4.

Query Params

FieldTypeDescriptionCharacters
page_numberintegerCurrent page being queried.-
page_sizeintegerNumber of results per page.-

Response

STATUS
200
Response Body: Key active
{
"data": [
{
"pix_key": "ecdb1790-667f-42ab-b319-fbc838a04672",
"pix_key_type": "random_key",
"pix_key_status": "active",
"created_at": "2021-10-22T20:30:23.459Z"
},
{
"pix_key": "f5eb52c1-5247-4de3-9982-f4f0ee9edad4",
"pix_key_type": "random_key",
"pix_key_status": "active",
"created_at": "2021-12-06T21:16:12.123Z"
}
],
"pagination": {
"current_page": 1,
"next_page": null,
"rows_per_page": 10
}
}

Response Body Params

FieldTypeDescriptionMax. Characters
pix_keystringPIX key.77
pix_key_typestringType of the PIX key. Can be "random_key"10
pix_key_statusstringActivation status of the PIX key. Can be "active", "inactive" or "pending"8
created_atdatetime ZuluDate of creation of the request.20
STATUS
4XX
Response Body: Error
{
"title": "titulo",
"description": "description in English",
"translation": "description in portuguese",
"code": "codigo",
"extra_fields": {}
}
HTTP CodeQI Code
code
Title
title
Description (eng)
Description
Description (ptbr)
translation
403PIX000080Not enough permissionThe selected agent is not an Pix Indirect ParticipantO agente selecionado não é um Participante Indireto do Pix
404PIX000082Alias not foundAlias {alias_key} not foundAlias {alias_key} não encontrado
400PIX000088Page size too largeRequested page size above limit of {max_page_size}Tamanho de página requerido acima do limite de {max_page_size}
400PIX000089Invalid value for paramsPage Size and Page Number must be integersage Size e Page Number devem ser números inteiros