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

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency

string

required

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.

Body

application/json

dtMovto

string

required

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

Example:

"2026-09-22"

cnpjNLiqdant

string

Filter to one non-liquidante's CNPJ.

Example:

"12345678000199"

identdPartCamr

string

Filter to one câmara participant identifier.

Example:

"00012345"

ispbIFLiqdant

string

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

Example:

"12345678"

numCtrlLTROr

string

Filter to one câmara-minted control number.

Example:

"20260922000000000041"

numOpLTR

string

Filter to one LTR operation number.

Example:

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

Example:

"001"

tpDebCred

string

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

Example:

"DEBIT"

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

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

Authorizations

Headers

Body

Response