Get STR message detail

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

package main

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

func main() {

	url := "https://api.example.com/v1/str/messages/{nuOp}"

	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/v1/str/messages/{nuOp}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "correlationId": "req-7a3f9c2e",
  "message": {
    "createdAt": "2026-05-04T18:29:55Z",
    "direction": "OUTBOUND",
    "messageType": "STR0004",
    "nuOp": "12345678202605040000001",
    "amount": "150.00",
    "confirmedAt": "2026-05-04T18:30:05Z",
    "controlNumber": "20260503000000000001",
    "description": "Wire transfer for invoice 2026-Q2-A47",
    "mqMessageId": "414d5120514d2020202020202020202060f0c2a201a30b25",
    "originalControlNumber": "20260503000000000042",
    "originalNuOp": "12345678202605040000001",
    "purposeCode": "00001",
    "recipientIspb": "00038166",
    "resolvedAt": "2026-05-04T18:30:05Z",
    "senderIspb": "12345678",
    "status": "DELIVERED",
    "strRejectReason": "AB03",
    "strStatus": "Acatado",
    "submittedAt": "2026-05-04T18:30:00Z"
  },
  "payload": {},
  "payloadFormat": "reconstructed",
  "correspondent": {
    "createdAt": "2026-05-04T18:30:02Z",
    "direction": "INBOUND",
    "messageType": "STR0004R2",
    "nuOp": "12345678202605040000001",
    "status": "RECEIVED",
    "amount": "150.00",
    "controlNumber": "20260503000000000001",
    "strStatus": "Acatado"
  }
}

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

Get STR message detail

Returns the message-log detail for an STR message identified by its NUOp: the status and BACEN-receipt fields, the structured payload, and the resolved original<->correspondent counterpart. The signed on-wire frame is NOT returned here — it is read at GET /v1/str/messages/{nuOp}/frame, guarded by its own scope; this body only labels whether one was retained (payloadFormat). Searches outbound messages first, then inbound ones by their own NUOp, then by the BACEN NUOp they arrived with (the nuOp str.operation.received carries). The NUOp is a 23-character BACEN identifier: ISPB[8]+DATE[8]+SEQ[7].

GET

str

messages

{nuOp}

Get STR message detail

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

package main

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

func main() {

	url := "https://api.example.com/v1/str/messages/{nuOp}"

	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/v1/str/messages/{nuOp}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "correlationId": "req-7a3f9c2e",
  "message": {
    "createdAt": "2026-05-04T18:29:55Z",
    "direction": "OUTBOUND",
    "messageType": "STR0004",
    "nuOp": "12345678202605040000001",
    "amount": "150.00",
    "confirmedAt": "2026-05-04T18:30:05Z",
    "controlNumber": "20260503000000000001",
    "description": "Wire transfer for invoice 2026-Q2-A47",
    "mqMessageId": "414d5120514d2020202020202020202060f0c2a201a30b25",
    "originalControlNumber": "20260503000000000042",
    "originalNuOp": "12345678202605040000001",
    "purposeCode": "00001",
    "recipientIspb": "00038166",
    "resolvedAt": "2026-05-04T18:30:05Z",
    "senderIspb": "12345678",
    "status": "DELIVERED",
    "strRejectReason": "AB03",
    "strStatus": "Acatado",
    "submittedAt": "2026-05-04T18:30:00Z"
  },
  "payload": {},
  "payloadFormat": "reconstructed",
  "correspondent": {
    "createdAt": "2026-05-04T18:30:02Z",
    "direction": "INBOUND",
    "messageType": "STR0004R2",
    "nuOp": "12345678202605040000001",
    "status": "RECEIVED",
    "amount": "150.00",
    "controlNumber": "20260503000000000001",
    "strStatus": "Acatado"
  }
}

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

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

nuOp

string

requerido

Message NUOp (23 characters: ISPB[8]+DATE[8]+SEQ[7]).

Required string length: 23

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

Respuesta

correlationId

string

requerido

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

Ejemplo:

"req-7a3f9c2e"

message

object

requerido

The message's status projection (identifiers, lifecycle, BACEN-receipt fields).

Show child attributes

payload

object

requerido

The structured payload_json persisted for this message (parsed STR fields). Always present.

Show child attributes

payloadFormat

enum<string>

requerido

Availability label for the signed on-wire frame: 'reconstructed' means a frame was retained for this message and is readable at GET /v1/str/messages/{nuOp}/frame (guarded by its own scope), 'structured' means no on-wire bytes were retained and only the payload fields above exist.

Opciones disponibles:

reconstructed,

structured

Ejemplo:

"reconstructed"

correspondent

object

The resolved original<->correspondent counterpart: for an outbound, the inbound response BACEN sent back; for an inbound, the outbound it answers. Absent when no counterpart has been correlated yet.

Show child attributes

Auditoría

Capacidades

Certificados

Depósitos compulsorios (RCO)

Mensajes

Aprobaciones de emisión

Eventos

Avisos GEN

Gobernanza

Inteligencia operativa

Operaciones

Readiness

Conciliación

Redescuento (RDC)

Informes

Consultas de reserva

Responsables

Programación

Consultas de programación

Configuración

Cargos del BACEN (SLB)

Consultas SME

Manejo de errores

Get STR message detail

Autorizaciones

Parámetros de ruta

Respuesta