Get Conta-PI liquidity transfer status

Reads the projection of a previously submitted LPI Conta-PI liquidity transfer by its operation id. Returns PENDING until the inbound STR R-leg (LPI0001R1 / LPI0003R1) 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 a position.

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

Get Conta-PI liquidity transfer status

cURL

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

200

{
  "amount": "1500.25",
  "correlationId": "req-7a3f9c2e",
  "direction": "aporte",
  "operationId": "7c8b3a2e-9f1d-4a55-9b8e-1e1234567890",
  "status": "PENDING",
  "nuOp": "12345678202606190000001",
  "numCtrlSTR": "20260619000001",
  "originalControlNumber": "STR20260610000000123",
  "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

Liquidity-transfer 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"

direction · enum<string> · requerido

Operator-facing movement direction.

Opciones disponibles: aporte, resgate

Ejemplo:

"aporte"

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), or REJECTED.

Opciones disponibles: PENDING, SETTLED, REJECTED

Ejemplo:

"PENDING"

nuOp · string

SFN operation number stamped on the transmitted LPI frame. Empty until the transfer 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"

originalControlNumber · string

STR control number of the undue aporte this resgate returns (NumCtrlSTROr, finalidadeLPI 2), as the operator quoted it. Empty on every other movement.

Ejemplo:

"STR20260610000000123"

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"