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

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/spi/account-reports/{correlationId}/extract"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/api/v1/spi/account-reports/{correlationId}/extract', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/api/v1/spi/account-reports/{correlationId}/extract"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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"
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

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

spi

account-reports

{correlationId}

extract

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

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

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/spi/account-reports/{correlationId}/extract"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.example.com/api/v1/spi/account-reports/{correlationId}/extract', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/api/v1/spi/account-reports/{correlationId}/extract"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "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"
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

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

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[]

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

ISPB (8 digits or uppercase letters) 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"