Read a Conta PI extrato (camt.052 RCO lançamentos result)

Result step of the account-reporting chain (camt.060 SOLIC_REL_LANCAMENTO request → camt.052 extrato read). Returns the RCO lançamentos rows BACEN generated on the ARQ rail, fetched + SHA-256-verified + parsed + projected verbatim, keyed by the camt.060 correlation id. Reads PENDING until the camt.052 extrato is received and verified, then ANSWERED with the parsed rows plus the integrity and row-COUNT recon status (declaredEntryCount vs parsedEntryCount). Lerian SPI projects the extrato BACEN sends and reconciles its integrity + row count; it never sums an amount nor computes a position.

GET /api/v1/spi/account-reports/{correlationId}/extract

Read a Conta PI extrato (camt.052 RCO lançamentos result)

cURL

curl --request GET \
  --url https://spi.sandbox.lerian.net/api/v1/spi/account-reports/{correlationId}/extract \
  --header 'Authorization: Bearer <token>'

200

{
  "correlationId": "M12345678Abc123Def456Ghi789Jkl0",
  "countsMatch": true,
  "declaredEntryCount": 16,
  "entries": [
    {
      "columns": {},
      "lineNumber": 1
    }
  ],
  "integrityVerified": true,
  "parsedEntryCount": 16,
  "status": "ANSWERED",
  "accountIspb": "99999010",
  "fileName": "0c71ebdc4736bf09a888457750aa22f7c895026afb64b40f8fbd94092c61c19b",
  "receivedAt": "2026-06-15T10:00:01Z",
  "reportKind": "DEMONST_RCO"
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

correlationId · string · requerido

Correlation id returned by createAccountReportRequest (the camt.060 AppHdr BizMsgIdr)

Respuesta

200

application/json

OK

correlationId · string · requerido

camt.060 AppHdr BizMsgIdr correlating the request to its camt.052 extrato response

Ejemplo:

"M12345678Abc123Def456Ghi789Jkl0"

countsMatch · boolean · requerido

COUNT recon FLAG: declaredEntryCount == parsedEntryCount. A mismatch is operator-reviewable, never fatal

Ejemplo:

true

declaredEntryCount · integer<int64> · requerido

camt.052 NbOfNtries (quantidadeLancamentos) — the declared record count

Ejemplo:

16

entries · object[] | null · requerido

RCO lançamentos rows BACEN generated, projected verbatim. Empty while PENDING

Show child attributes

integrityVerified · boolean · requerido

True when sha256(fetched file) == AddtlRptInf (integrity passed)

Ejemplo:

true

parsedEntryCount · integer<int64> · requerido

Number of RCO data rows parsed from the file

Ejemplo:

16

status · string · requerido

PENDING until the inbound camt.052 extrato is fetched + verified + projected; ANSWERED once it has been persisted

Ejemplo:

"ANSWERED"

accountIspb · string

8-digit ISPB of the Conta PI account the extrato addresses (Rpt/Acct/Id), verbatim. Empty while PENDING

Ejemplo:

"99999010"

fileName · string

AddtlRptInf file handle (== SHA-256 of the file content). Empty while PENDING

Ejemplo:

"0c71ebdc4736bf09a888457750aa22f7c895026afb64b40f8fbd94092c61c19b"

receivedAt · string<date-time>

RFC3339 UTC freshness timestamp the extrato was projected. Empty while PENDING

Ejemplo:

"2026-06-15T10:00:01Z"

reportKind · string

Detected RCO shape: DEMONST_RCO (saque-facilitator demonstrativo), TOTAL_RCO (per-account-pair totals), or UNKNOWN. Empty while PENDING

Ejemplo:

"DEMONST_RCO"