Read rediscount operation status

curl --request GET \
  --url https://spb.sandbox.lerian.net/v1/str/operations/rediscounts/{operationId} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/operations/rediscounts/{operationId}"

	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://spb.sandbox.lerian.net/v1/str/operations/rediscounts/{operationId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://spb.sandbox.lerian.net/v1/str/operations/rediscounts/{operationId}"

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

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

print(response.text)

{
  "amount": "1500000.00",
  "correlationId": "req-7a3f9c2e",
  "id": "9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
  "kind": "contract",
  "movementDate": "2026-06-15",
  "selicOperation": "000123",
  "status": "ACCEPTED",
  "wireCode": "RDC0002",
  "bacenStatusAt": "2026-06-15T09:30:00",
  "nuOp": "12345678202606150000014",
  "numCtrlRDC": "RDC20260615000000001",
  "numCtrlSTR": "STR20260615000001",
  "originalHandle": "RDC20260615000000001",
  "rejectionReason": "<string>",
  "remainingBalance": "500000.00",
  "settledAt": "2026-06-15T12:30:01Z",
  "sitLancRDC": "16",
  "supersededById": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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

{
  "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 rediscount operation status

Reads the lifecycle of a commanded rediscount by its operation id. PENDING until BACEN answers, then one of five states — and the distinction between two of them is the point of this read. ACCEPTED means BACEN registered the request and Selic is HOLDING it because the institution is short of securities: it is neither settled nor failed, no money moved, and the end-of-day sweep may still cancel it or roll it into one business day. SETTLED means a Reservas Bancárias entry exists, evidenced by the numCtrlSTR BACEN stamped, and it is deliberately NOT terminal — a settled rediscount is still an open borrowing until it is repaid, converted or swept. A payment response also reports the remaining balance BACEN sent, verbatim: Lerian SPB never derives it by subtracting a payment from a contract.

GET

str

operations

rediscounts

{operationId}

Read rediscount operation status

curl --request GET \
  --url https://spb.sandbox.lerian.net/v1/str/operations/rediscounts/{operationId} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/operations/rediscounts/{operationId}"

	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://spb.sandbox.lerian.net/v1/str/operations/rediscounts/{operationId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://spb.sandbox.lerian.net/v1/str/operations/rediscounts/{operationId}"

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

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

print(response.text)

{
  "amount": "1500000.00",
  "correlationId": "req-7a3f9c2e",
  "id": "9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
  "kind": "contract",
  "movementDate": "2026-06-15",
  "selicOperation": "000123",
  "status": "ACCEPTED",
  "wireCode": "RDC0002",
  "bacenStatusAt": "2026-06-15T09:30:00",
  "nuOp": "12345678202606150000014",
  "numCtrlRDC": "RDC20260615000000001",
  "numCtrlSTR": "STR20260615000001",
  "originalHandle": "RDC20260615000000001",
  "rejectionReason": "<string>",
  "remainingBalance": "500000.00",
  "settledAt": "2026-06-15T12:30:01Z",
  "sitLancRDC": "16",
  "supersededById": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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

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

Autorizações

Authorization

string

header

obrigatório

JWT bearer token issued by the identity provider.

Parâmetros de caminho

operationId

string<uuid>

obrigatório

Rediscount operation UUID returned by the create endpoint.

Resposta

amount

string

obrigatório

Commanded amount, verbatim.

Exemplo:

"1500000.00"

correlationId

string

obrigatório

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

Exemplo:

"req-7a3f9c2e"

string<uuid>

obrigatório

Rediscount operation UUID.

Exemplo:

"9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"

kind

string

obrigatório

Operator-facing command kind.

Exemplo:

"contract"

movementDate

string

obrigatório

BACEN business date (DtMovto) the frame was sent for.

Exemplo:

"2026-06-15"

selicOperation

string

obrigatório

Selic operation number this frame carried.

Exemplo:

"000123"

status

enum<string>

obrigatório

Lifecycle state. PENDING = submitted, nothing heard. ACCEPTED = BACEN took the request and Selic is HOLDING it for want of securities — registered, NOT settled, no settlement fact emitted. SETTLED = a Reservas Bancárias entry exists (numCtrlSTR proves it). REJECTED = BACEN refused it. CANCELLED = withdrawn, or swept at STR close. CONVERTED = liquidated by a conversion, or rolled into one business day by the end-of-day sweep. SETTLED is deliberately NOT terminal: a settled rediscount is still an open borrowing until it is repaid.

Opções disponíveis:

PENDING,

ACCEPTED,

SETTLED,

REJECTED,

CANCELLED,

CONVERTED

Exemplo:

"ACCEPTED"

wireCode

string

obrigatório

RDC message code that was put on the wire.

Exemplo:

"RDC0002"

bacenStatusAt

string

BACEN's own situation timestamp (DtHrSit), verbatim as the wire spells it. Deliberately not parsed: BACEN's clock and this deployment's are two different facts.

Exemplo:

"2026-06-15T09:30:00"

nuOp

string

SFN operation number of the transmitted frame. Empty when the submit failed.

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

Exemplo:

"12345678202606150000014"

numCtrlRDC

string

Handle BACEN minted for this operation. Every later message quotes it as originalHandle.

Exemplo:

"RDC20260615000000001"

numCtrlSTR

string

Settlement reference BACEN sent. Its ABSENCE on an accepted operation is the pending state, not a missing field: a SETTLED operation always carries it, because it is the only evidence a Reservas Bancárias entry exists.

Exemplo:

"STR20260615000001"

originalHandle

string

BACEN handle of the operation this command acted on. Empty on a contract.

Exemplo:

"RDC20260615000000001"

rejectionReason

string

Operator-facing reason the operation went REJECTED.

remainingBalance

string

Remaining balance (SldAtl) BACEN REPORTED on a payment response, verbatim as text. Never derived by subtracting a payment from a contract. The operation stays open until it reaches zero.

Exemplo:

"500000.00"

settledAt

string<date-time>

RFC3339 UTC timestamp this deployment projected the terminal answer — a freshness stamp, never a BACEN fact.

Exemplo:

"2026-06-15T12:30:01Z"

sitLancRDC

string

BACEN situation code (SitLancRDC), verbatim.

Exemplo:

"16"

supersededById

string<uuid>

Set when a conversion liquidated this operation: the id of the replacement that superseded it.

Auditoria

Capacidades

Certificados

Recolhimento compulsório (RCO)

Mensagens

Aprovações de emissão

Entregas de eventos

Eventos

Avisos GEN

Governança

Inteligência operacional

Operações

Readiness

Conciliação

Redesconto (RDC)

Relatórios

Consultas de reserva

Responsáveis

Agendamento

Consultas de agendamento

Configurações

Cobranças do BACEN (SLB)

Consultas SME

Webhooks

Tratamento de erros

Read rediscount operation status

Autorizações

Parâmetros de caminho

Resposta