Enviar consulta de horarios STR0001

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/schedule-queries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dtRef": "<string>",
  "ispbIf": "<string>",
  "tpHrio": "<string>"
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/schedule-queries"

payload = {
    "dtRef": "<string>",
    "ispbIf": "<string>",
    "tpHrio": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({dtRef: '<string>', ispbIf: '<string>', tpHrio: '<string>'})
};

fetch('https://spb.sandbox.lerian.net/v1/str/schedule-queries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://spb.sandbox.lerian.net/v1/str/schedule-queries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'dtRef' => '<string>',
    'ispbIf' => '<string>',
    'tpHrio' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/schedule-queries"

	payload := strings.NewReader("{\n  \"dtRef\": \"<string>\",\n  \"ispbIf\": \"<string>\",\n  \"tpHrio\": \"<string>\"\n}")

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

	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))

}

HttpResponse<String> response = Unirest.post("https://spb.sandbox.lerian.net/v1/str/schedule-queries")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dtRef\": \"<string>\",\n  \"ispbIf\": \"<string>\",\n  \"tpHrio\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/schedule-queries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"dtRef\": \"<string>\",\n  \"ispbIf\": \"<string>\",\n  \"tpHrio\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "correlationId": "<string>",
  "dtRef": "<string>",
  "id": "<string>",
  "ispbIf": "<string>",
  "status": "<string>",
  "submittedAt": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Enviar consulta de horarios STR0001

Envía a BACEN una consulta de horarios STR0001 de parte única (consulta de horários do STR) y devuelve un id de correlación más un estado PENDING. La respuesta (STR0001R1, que lleva la grilla de horario de operación del STR) llega de forma asíncrona y se lee mediante GET /v1/str/schedule-queries/. Esto significa que la consulta fue aceptada para despacho, no que el horario ya esté disponible. Lerian SPB expone el horario que envía BACEN; no calcula nada.

POST

str

schedule-queries

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/schedule-queries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dtRef": "<string>",
  "ispbIf": "<string>",
  "tpHrio": "<string>"
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/schedule-queries"

payload = {
    "dtRef": "<string>",
    "ispbIf": "<string>",
    "tpHrio": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({dtRef: '<string>', ispbIf: '<string>', tpHrio: '<string>'})
};

fetch('https://spb.sandbox.lerian.net/v1/str/schedule-queries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://spb.sandbox.lerian.net/v1/str/schedule-queries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'dtRef' => '<string>',
    'ispbIf' => '<string>',
    'tpHrio' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/schedule-queries"

	payload := strings.NewReader("{\n  \"dtRef\": \"<string>\",\n  \"ispbIf\": \"<string>\",\n  \"tpHrio\": \"<string>\"\n}")

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

	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))

}

HttpResponse<String> response = Unirest.post("https://spb.sandbox.lerian.net/v1/str/schedule-queries")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dtRef\": \"<string>\",\n  \"ispbIf\": \"<string>\",\n  \"tpHrio\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/schedule-queries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"dtRef\": \"<string>\",\n  \"ispbIf\": \"<string>\",\n  \"tpHrio\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "correlationId": "<string>",
  "dtRef": "<string>",
  "id": "<string>",
  "ispbIf": "<string>",
  "status": "<string>",
  "submittedAt": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Encabezados

Authorization

string

Bearer JWT token.

X-Idempotency

string

Idempotency key (canonical; legacy alias X-Idempotency-Key).

X-Idempotency-Key

string

Idempotency key (legacy alias).

X-TTL

string

Idempotency key TTL in seconds.

Cuerpo

application/json

dtRef

string

requerido

Reference date (Data Referência, DtRef) the STR schedule grid is requested for. Required.

Ejemplo:

"2026-06-15"

ispbIf

string

requerido

ISPB of the querying financial institution (8 numeric digits).

Ejemplo:

"12345678"

tpHrio

string

Schedule type (Tipo Horário): P (padrão/standard) or E (eventual). Optional — absent returns both standard and eventual grids in force on DtRef (RSTR0001/0002/0003).

Ejemplo:

"P"

Respuesta

Accepted

correlationId

string

requerido

Request-scoped correlation identifier echoing X-Request-ID.

Ejemplo:

"req-7a3f9c2e"

dtRef

string

requerido

Reference date the schedule grid was requested for.

Ejemplo:

"2026-06-15"

string

requerido

Correlation id (the outbound STR0001 NUOp). Poll GET /v1/str/schedule-queries/{id} for the answer.

Ejemplo:

"12345678202606150000001"

ispbIf

string

requerido

ISPB of the querying financial institution.

Ejemplo:

"12345678"

status

string

requerido

Projection state: PENDING until the STR0001R1 answer arrives and is projected.

Ejemplo:

"PENDING"

submittedAt

string

requerido

RFC3339 UTC timestamp the STR0001 query was persisted before send.

Ejemplo:

"2026-06-15T12:00:00Z"

⌘I

Pix — Lerian SPI (mensajería nativa)

Pix — JD (interfaz, directo)

Pix — BTG (interfaz, indirecto)

TED — Lerian SPB (mensajería nativa)

TED — JD (interfaz)

Boletos — BTG (interfaz)

Lerian SILOC (mensajería nativa)

Lerian SLC (mensajería nativa)

Lerian STA (mensajería nativa)

Lerian SISBAJUD (mensajería nativa)

Lerian Consignado (mensajería nativa)

Enviar consulta de horarios STR0001

Autorizaciones

Encabezados

Cuerpo

Respuesta