Movimento financeiro report

Returns, per (messageType, direction), the SUM of the declared amount + a COUNT over messages_outbound / messages_inbound created within the date range, plus a grand total per direction. The decimal sum is accumulated in integer centavos (never float). This sums Lerian SPB’s OWN transmitted/received amounts — a derived report view, not a held position. BACEN-supplied reserve balances are NOT projected here (use GET /v1/str/reserve-statement-queries/); movement never rolls movements up into an opening/closing balance.

GET /v1/str/reports/movement

Movimento financeiro report

cURL

curl --request GET \
  --url https://spb.sandbox.lerian.net/v1/str/reports/movement \
  --header 'Authorization: Bearer <token>'

200

{
  "correlationId": "<string>",
  "fromDate": "<string>",
  "rows": [
    {
      "amountTotal": "<string>",
      "count": 123,
      "direction": "<string>",
      "messageType": "<string>"
    }
  ],
  "toDate": "<string>",
  "totals": [
    {
      "amountTotal": "<string>",
      "count": 123,
      "direction": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Query Parameters

fromDate · string · required

Inclusive range start (RFC3339 timestamp or YYYY-MM-DD).

Example:

"2026-05-01"

toDate · string · required

Inclusive range end (RFC3339 timestamp or YYYY-MM-DD). A bare date snaps to end-of-day.

Example:

"2026-05-31"

messageType · string

Optional STR/LPI message-code filter (e.g. STR0008).

Response

200

application/json

OK

correlationId · string · required

Request-scoped correlation identifier echoing X-Request-ID.

Example:

"req-7a3f9c2e"

fromDate · string · required

RFC3339 UTC inclusive lower bound of the queried range.

Example:

"2026-05-01T00:00:00Z"

rows · object[] | null · required

Per (messageType, direction) SUM(amount) + COUNT, ordered by messageType then direction.

Show child attributes

toDate · string · required

RFC3339 UTC inclusive upper bound of the queried range.

Example:

"2026-05-31T23:59:59Z"

totals · object[] | null · required

Grand total (SUM + COUNT) per direction across every messageType.

Show child attributes