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

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency

string

required

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

Path Parameters

resultId

string

required

Announced result id (UUID).

Example:

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

Body

application/json

announcedAmount

string

required

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.

Example:

"1234.56"

decision

string

required

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.

Example:

"CONFIRM"

Response

Accepted

commandId

string

required

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.

Example:

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

messageType

string

required

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

Example:

"LTR0002"

requestedAt

string

required

When the institution decided (RFC3339, UTC).

Example:

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

sourceAggregateId

string

required

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

Example:

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

sourceAggregateVersion

integer<int64>

required

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

Example:

1

status

string

required

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.

Example:

"REQUESTED"

Administration

Clearing

Settlement schedule

Funding

LBTR

Connectivity

Operations

Files

Participants

Arrangements

Reports

Signing keys

XSD schemas

Webhooks

Error handling

Confirm or diverge from an announced settlement result

Authorizations

Headers

Path Parameters

Body

Response