Get SME electronic-money movement status

Reads the projection of a previously submitted SME movement of an IEME’s conta correspondente a moeda eletrônica (CCME) by its operation id. Returns PENDING until the inbound STR R-leg (SME0001R1 / SME0002R1 / SME0004R1) arrives, then SETTLED (or REJECTED) with the STR settlement confirmation (numCtrlSTR / sitLancSTR) BACEN sent, projected verbatim. Unknown ids surface as not-found (SPB-0010). Lerian SPB projects the settlement; it never computes or holds a CCME position.

GET /v1/str/operations/sme-transfers/{operationId}

Get SME electronic-money movement status

cURL

curl --request GET \
  --url https://api.example.com/v1/str/operations/sme-transfers/{operationId} \
  --header 'Authorization: Bearer <token>'

200

{
  "amount": "1500.25",
  "correlationId": "req-7a3f9c2e",
  "kind": "deposit",
  "operationId": "7c8b3a2e-9f1d-4a55-9b8e-1e1234567890",
  "status": "PENDING",
  "wireCode": "SME0001",
  "nuOp": "12345678202606190000001",
  "numCtrlSTR": "20260619000001",
  "rejectionReason": "insufficient reserve balance",
  "sitLancSTR": "LIQ"
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

operationId · string<uuid> · requerido

SME movement operation UUID returned by the create endpoint.

Respuesta

200

application/json

OK

amount · string · requerido

Movement amount as a decimal-reais string, verbatim.

Ejemplo:

"1500.25"

correlationId · string · requerido

Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.

Ejemplo:

"req-7a3f9c2e"

kind · enum<string> · requerido

Operator-facing movement kind the request named.

Opciones disponibles: deposit, withdrawal, return

Ejemplo:

"deposit"

operationId · string<uuid> · requerido

Operation UUID.

Ejemplo:

"7c8b3a2e-9f1d-4a55-9b8e-1e1234567890"

status · enum<string> · requerido

Projection lifecycle status: PENDING (awaiting the STR R-leg), SETTLED (R-leg confirmed), REJECTED, or CANCELLED (the STR cancelled the entry, SitLancSTR 14 or 15).

Opciones disponibles: PENDING, SETTLED, REJECTED, CANCELLED

Ejemplo:

"PENDING"

wireCode · enum<string> · requerido

SME wire code derived server-side from the kind: deposit=SME0001, withdrawal=SME0002, return=SME0004.

Opciones disponibles: SME0001, SME0002, SME0004

Ejemplo:

"SME0001"

nuOp · string

SFN operation number stamped on the transmitted SME frame. Empty until the movement has been submitted to STR.

Pattern: ^[0-9A-Z]{8}[0-9]{15}$

Ejemplo:

"12345678202606190000001"

numCtrlSTR · string

STR control number BACEN sent on the R-leg settlement confirmation, verbatim. Empty while PENDING.

Ejemplo:

"20260619000001"

rejectionReason · string

Failure detail when the status is REJECTED. Empty otherwise.

Ejemplo:

"insufficient reserve balance"

sitLancSTR · string

STR settlement status BACEN sent on the R-leg, verbatim. Empty while PENDING.

Ejemplo:

"LIQ"