Skip to main content
GET
Retrieve a consultation

Autorizações

Authorization
string
header
obrigatório

The access token received from the authorization server in the OAuth 2.0 flow.

Cabeçalhos

X-Request-ID
string

Optional correlation id (UUID) propagated through logs/traces.

Parâmetros de caminho

id
string
obrigatório

Consultation identifier (UUID). A malformed identifier returns 400 SRC-0001.

Exemplo:

"8f14e45f-ceea-467a-9a36-dedd4bea2543"

Resposta

OK

acceptedAt
string<date-time>
obrigatório

Acceptance instant (RFC3339).

attempts
object
obrigatório

Dispatch attempt history summary.

bcbProcessedAt
string<date-time> | null
obrigatório

Processing instant at BACEN (DtHrBC); null until completed.

companyConsultationId
string | null
obrigatório

The company consultation this holder or representative belongs to — the LINK, seen from the child. null for individual and company. Follow it with GET /v1/src/consultations/{id}; list the other children with GET /v1/src/consultations?companyConsultationId={id}. Its verdict and this one never couple: the decision is the institution's (arts. 2º-A/4º-A §3º).

concludedAt
string<date-time> | null
obrigatório

Conclusion instant; null while pending.

documentMasked
string
obrigatório

Masked consulted document.

Exemplo:

"529******25"

documentType
string
obrigatório

Type of the consulted document.

Exemplo:

"CPF"

id
string
obrigatório

Consultation identifier.

Exemplo:

"8f14e45f-ceea-467a-9a36-dedd4bea2543"

institutionRecord
object
obrigatório

The ONE record the institution filed against this consultation (arts. 2º-A/4º-A): kind "exceptional_proceed" (§1º — it contracted despite the active restriction, with a justification and a circumstance) or "refusal_explanation" (§2º — it refused, and this is what the interested party was told). The two are mutually exclusive. null when none was filed; immutable once filed.

motivation
object
obrigatório

The recorded motivation context.

protectionTypes
string[] | null
obrigatório

The consulted protection types, in request order.

rejection
object
obrigatório

Present when failed by a BACEN technical rejection (code preserved verbatim); null otherwise.

status
string
obrigatório

Lifecycle state: pending | completed | failed. pending is a NORMAL state, never an error.

Exemplo:

"pending"

subjectRole
string
obrigatório

The role the consulted document plays: individual | company | holder | representative. Always present.

Exemplo:

"representative"

bcbControlCode
string

Consultation control code assigned by BACEN (NumCtrlSRC).

Exemplo:

"SRC20260826000000123"

regulatoryOperationNumber
string

The operation number (NUOp) that Lerian SRC creates for the consultation. It has 23 characters: the institution's 8-character CNPJ base, an 8-digit date and a 7-digit sequence. Use it to reconcile the operation with BACEN's records. Absent until the dispatch is opened.

Exemplo:

"12345678202609100000001"

verdicts
object[] | null

Present when completed — one verdict per consulted protection type.