Ask the câmara for this institution's LBTR position

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/lbtr/position-queries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "dtMovto": "2026-09-22",
  "cnpjNLiqdant": "12345678000199",
  "identdPartCamr": "00012345",
  "ispbIFLiqdant": "12345678",
  "numCtrlLTROr": "20260922000000000041",
  "numOpLTR": "0000000000000000123",
  "sitLancLTR": "001",
  "tpDebCred": "DEBIT"
}
'

package main

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

func main() {

	url := "https://slc.sandbox.lerian.net/v1/lbtr/position-queries"

	payload := strings.NewReader("{\n  \"dtMovto\": \"2026-09-22\",\n  \"cnpjNLiqdant\": \"12345678000199\",\n  \"identdPartCamr\": \"00012345\",\n  \"ispbIFLiqdant\": \"12345678\",\n  \"numCtrlLTROr\": \"20260922000000000041\",\n  \"numOpLTR\": \"0000000000000000123\",\n  \"sitLancLTR\": \"001\",\n  \"tpDebCred\": \"DEBIT\"\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({
    dtMovto: '2026-09-22',
    cnpjNLiqdant: '12345678000199',
    identdPartCamr: '00012345',
    ispbIFLiqdant: '12345678',
    numCtrlLTROr: '20260922000000000041',
    numOpLTR: '0000000000000000123',
    sitLancLTR: '001',
    tpDebCred: 'DEBIT'
  })
};

fetch('https://slc.sandbox.lerian.net/v1/lbtr/position-queries', 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/position-queries"

payload = {
    "dtMovto": "2026-09-22",
    "cnpjNLiqdant": "12345678000199",
    "identdPartCamr": "00012345",
    "ispbIFLiqdant": "12345678",
    "numCtrlLTROr": "20260922000000000041",
    "numOpLTR": "0000000000000000123",
    "sitLancLTR": "001",
    "tpDebCred": "DEBIT"
}
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"
  }
}

Ask the câmara for this institution's LBTR position

Asks the câmara for this institution’s own financial position (LTR0009). dtMovto is required; every other field is a filter. Asynchronous intake — 202 means the query is committed and nothing has been sent yet; the câmara’s answer is read back from GET /v1/lbtr/commands/, projected exactly as it arrived. The câmara’s ISPB is not a field here: this message answers nothing, so there is nothing to echo it from, and Lerian SILOC supplies it. sitLancLTR is the raw 3-digit situation code, passed through verbatim. X-Idempotency is REQUIRED and a repeat query needs a NEW key: two identical queries are two questions and each is entitled to its own answer. RBAC: lbtr:write; the asking operator and the tenant are always taken from the validated request identity, never from the payload.

POST

lbtr

position-queries

curl --request POST \
  --url https://slc.sandbox.lerian.net/v1/lbtr/position-queries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "dtMovto": "2026-09-22",
  "cnpjNLiqdant": "12345678000199",
  "identdPartCamr": "00012345",
  "ispbIFLiqdant": "12345678",
  "numCtrlLTROr": "20260922000000000041",
  "numOpLTR": "0000000000000000123",
  "sitLancLTR": "001",
  "tpDebCred": "DEBIT"
}
'

package main

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

func main() {

	url := "https://slc.sandbox.lerian.net/v1/lbtr/position-queries"

	payload := strings.NewReader("{\n  \"dtMovto\": \"2026-09-22\",\n  \"cnpjNLiqdant\": \"12345678000199\",\n  \"identdPartCamr\": \"00012345\",\n  \"ispbIFLiqdant\": \"12345678\",\n  \"numCtrlLTROr\": \"20260922000000000041\",\n  \"numOpLTR\": \"0000000000000000123\",\n  \"sitLancLTR\": \"001\",\n  \"tpDebCred\": \"DEBIT\"\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({
    dtMovto: '2026-09-22',
    cnpjNLiqdant: '12345678000199',
    identdPartCamr: '00012345',
    ispbIFLiqdant: '12345678',
    numCtrlLTROr: '20260922000000000041',
    numOpLTR: '0000000000000000123',
    sitLancLTR: '001',
    tpDebCred: 'DEBIT'
  })
};

fetch('https://slc.sandbox.lerian.net/v1/lbtr/position-queries', 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/position-queries"

payload = {
    "dtMovto": "2026-09-22",
    "cnpjNLiqdant": "12345678000199",
    "identdPartCamr": "00012345",
    "ispbIFLiqdant": "12345678",
    "numCtrlLTROr": "20260922000000000041",
    "numOpLTR": "0000000000000000123",
    "sitLancLTR": "001",
    "tpDebCred": "DEBIT"
}
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. A retry carrying the same key replays the stored response instead of asking the câmara twice; a genuinely new query needs a new key.

Cuerpo

application/json

dtMovto

string

requerido

The settlement business day to query (the only required field).

Ejemplo:

"2026-09-22"

cnpjNLiqdant

string

Filter to one non-liquidante's CNPJ.

Ejemplo:

"12345678000199"

identdPartCamr

string

Filter to one câmara participant identifier.

Ejemplo:

"00012345"

ispbIFLiqdant

string

Filter to one settlement bank's ISPB. This is the COUNTERPARTY's settlement bank, never your own.

Ejemplo:

"12345678"

numCtrlLTROr

string

Filter to one câmara-minted control number.

Ejemplo:

"20260922000000000041"

numOpLTR

string

Filter to one LTR operation number.

Ejemplo:

"0000000000000000123"

sitLancLTR

string

Filter to one RAW 3-digit SitLancLTR situation code, passed through verbatim. The rail publishes no product enum for it: the domain has eighteen values and a filter that understands only some of them would silently lie about the rest.

Ejemplo:

"001"

tpDebCred

string

Filter to DEBIT or CREDIT entries (case-insensitive).

Ejemplo:

"DEBIT"

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

Ask the câmara for this institution's LBTR position

Autorizaciones

Encabezados

Cuerpo

Respuesta