Confirm or diverge from an announced settlement result

curl --request POST \
  --url https://api.example.com/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://api.example.com/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://api.example.com/v1/lbtr/results/{resultId}/decision', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/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://api.example.com/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://api.example.com/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://api.example.com/v1/lbtr/results/{resultId}/decision', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/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"
  }
}

Autorizações

Authorization

string

header

obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency

string

obrigatório

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

Parâmetros de caminho

resultId

string

obrigatório

Announced result id (UUID).

Exemplo:

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

Corpo

application/json

announcedAmount

string

obrigatório

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.

Exemplo:

"1234.56"

decision

string

obrigatório

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.

Exemplo:

"CONFIRM"

Resposta

Accepted

commandId

string

obrigatório

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.

Exemplo:

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

messageType

string

obrigatório

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

Exemplo:

"LTR0002"

requestedAt

string

obrigatório

When the institution decided (RFC3339, UTC).

Exemplo:

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

sourceAggregateId

string

obrigatório

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

Exemplo:

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

sourceAggregateVersion

integer<int64>

obrigatório

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

Exemplo:

1

status

string

obrigatório

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.

Exemplo:

"REQUESTED"

Administração

Compensação

Grade de liquidação

Aporte

LBTR

Conectividade

Operações

Arquivos

Participantes

Arranjos

Relatórios

Chaves de assinatura

Esquemas XSD

Webhooks

Tratamento de erros

Confirm or diverge from an announced settlement result

Autorizações

Cabeçalhos

Parâmetros de caminho

Corpo

Resposta