Skip to main content
GET
Get one authorization request

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Account-Id
string<uuid>
obrigatório

Non-zero UUID of the payer account selected by the calling PSP. The PSP must authorize its end user for that account before calling this API. A resource outside the selected account returns 404; a read with no records returns an empty page. See the API overview for the complete trust boundary.

Pattern: ^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$

Parâmetros de caminho

authorization_request_id
string
obrigatório

Payer-side request identifier, in ANY state — pending or already decided. It is the counterparty idSolicRec on journey 1 and a local identifier on QR journeys. Fixed 29-character shape (Manual de Padrões §2.2.1); one that does not parse into a well-formed identifier is refused with 422 (PIX-0810). A request or mandate under a different X-Account-Id is answered 404, not 403, so the caller cannot confirm that a resource exists elsewhere.

Required string length: 29
Pattern: ^SC[0-9A-Z]{8}[0-9]{8}[a-zA-Z0-9]{11}$
Exemplo:

"SC12345678202608276bca619e690"

Resposta

The authorization request, in any state.

authorizationRequestId
string
obrigatório

Payer-side request identifier. It is the counterparty idSolicRec on journey 1 and a local identifier on QR journeys; always pass this exact value to the decision route.

Exemplo:

"SC12345678202608276bca619e690"

expiresAt
string<date-time>
obrigatório

Decision deadline. At most 30 days from creation (Guia v1.2 §3.2).

Exemplo:

"2026-09-26T19:18:38Z"

receivedAt
string<date-time>
obrigatório

When this end received the request.

Exemplo:

"2026-08-27T19:18:38Z"

recurrenceId
string
obrigatório

BACEN idRec of the recurrence the request covers.

Exemplo:

"RR12345678202608276bca619e690"

status
string
obrigatório

Status the request currently holds -- pending on the listing surface, any lifecycle status on the individual GET.

Exemplo:

"RECEIVED"

decidedAt
string<date-time>

When the payer decided. Absent while the request is still pending.

Exemplo:

"2026-08-27T19:20:00Z"

journey
string

Authorization journey that produced the request. Absent on journey 1, whose inbound message names none.

Exemplo:

"JOURNEY_2"

rejectionReason
enum<string>

Motive the payer gave when refusing the recurrence. Present only when status is REJECTED.

Opções disponíveis:
NotRecognizedByDebtor,
RejectedByDebtor
Exemplo:

"NotRecognizedByDebtor"