Confirm or diverge from an announced settlement result

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/lbtr/results/{resultId}/decision \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "announcedAmount": "1234.56",
  "decision": "CONFIRM"
}
'

package main

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

func main() {

	url := "https://slc.sandbox.lerian.net/v1/lbtr/results/{resultId}/decision"

	payload := strings.NewReader("{\n  \"announcedAmount\": \"1234.56\",\n  \"decision\": \"CONFIRM\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({announcedAmount: '1234.56', decision: 'CONFIRM'})
};

fetch('https://slc.sandbox.lerian.net/v1/lbtr/results/{resultId}/decision', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://slc.sandbox.lerian.net/v1/lbtr/results/{resultId}/decision"

payload = {
    "announcedAmount": "1234.56",
    "decision": "CONFIRM"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "commandId": "0199a2e8-7a1c-7c1a-9e5d-2f6a1b3c4d5e",
  "messageType": "LTR0002",
  "requestedAt": "2026-09-22T13:04:11Z",
  "sourceAggregateId": "018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e",
  "sourceAggregateVersion": 1,
  "status": "REQUESTED"
}

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

Confirm or diverge from an announced settlement result

Answers a result the câmara announced (LTR0001) with the institution’s LTR0002: CONFIRM accepts it, DIVERGE disputes it. Asynchronous intake — 202 means the command and its outbound event are committed and nothing has been sent yet; poll the command to see the câmara’s answer. announcedAmount must equal the amount that was announced (422 otherwise), compared as a decimal. A result the câmara cancelled, or one already decided, is 409; an announcement that changed since it was read is 409 and should be read again. X-Idempotency is REQUIRED: a retry carrying the same key replays the stored response instead of sending a second answer, and the same key with a different body is 409. RBAC: lbtr:write; the deciding operator and the tenant are always taken from the validated request identity, never from the payload.

POST

lbtr

results

{resultId}

decision

Confirm or diverge from an announced settlement result

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/lbtr/results/{resultId}/decision \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "announcedAmount": "1234.56",
  "decision": "CONFIRM"
}
'

package main

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

func main() {

	url := "https://slc.sandbox.lerian.net/v1/lbtr/results/{resultId}/decision"

	payload := strings.NewReader("{\n  \"announcedAmount\": \"1234.56\",\n  \"decision\": \"CONFIRM\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({announcedAmount: '1234.56', decision: 'CONFIRM'})
};

fetch('https://slc.sandbox.lerian.net/v1/lbtr/results/{resultId}/decision', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://slc.sandbox.lerian.net/v1/lbtr/results/{resultId}/decision"

payload = {
    "announcedAmount": "1234.56",
    "decision": "CONFIRM"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "commandId": "0199a2e8-7a1c-7c1a-9e5d-2f6a1b3c4d5e",
  "messageType": "LTR0002",
  "requestedAt": "2026-09-22T13:04:11Z",
  "sourceAggregateId": "018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e",
  "sourceAggregateVersion": 1,
  "status": "REQUESTED"
}

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

Encabezados

X-Idempotency

string

requerido

Required. Scopes this answer so a retry replays the stored response instead of sending a second command for the same result.

Parámetros de ruta

resultId

string

requerido

Announced result id (UUID).

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

Cuerpo

application/json

announcedAmount

string

requerido

The announced amount you are answering for, as a decimal string (e.g. "1234.56"). It must EQUAL the amount the câmara announced or the command is refused with 422: a confirmation that does not say what it confirms is not auditable. Compared as a decimal, so "100.1" and "100.10" are the same money.

Ejemplo:

"1234.56"

decision

string

requerido

CONFIRM or DIVERGE (case-insensitive). CONFIRM accepts the announced result; DIVERGE disputes it. Both ride the same wire tag; the product words differ because the câmara's own event titles them differently.

Ejemplo:

"CONFIRM"

Respuesta

Accepted

commandId

string

requerido

The command's id (a UUIDv7 minted by this service). It is the key every later fact joins on and the id to read the command back by.

Ejemplo:

"0199a2e8-7a1c-7c1a-9e5d-2f6a1b3c4d5e"

messageType

string

requerido

The outbound message this command originates: LTR0002 (result answer), LTR0008 (non-liquidante answer) or LTR0009 (position query).

Ejemplo:

"LTR0002"

requestedAt

string

requerido

When the institution decided (RFC3339, UTC).

Ejemplo:

"2026-09-22T13:04:11Z"

sourceAggregateId

string

requerido

The announcement this command answers. For a position query it is the command's own id, because a query answers no announcement.

Ejemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

sourceAggregateVersion

integer<int64>

requerido

The version of the announcement this command was authorised against, kept so a later reader can see which view of it was answered.

Ejemplo:

1

status

string

requerido

Always REQUESTED here: the command row and its outbound event are committed and nothing has been sent yet. Poll the command to see it reach ACCEPTED, ANSWERED, REFUSED or FAILED.

Ejemplo:

"REQUESTED"

Administración

Compensación

Grilla de liquidación

Fondeo

LBTR

Conectividad

Operaciones

Archivos

Participantes

Acuerdos

Informes

Claves de firma

Esquemas XSD

Webhooks

Manejo de errores

Confirm or diverge from an announced settlement result

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta