Get a pre-auction auction

curl --request GET \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/consignado/preleilao/leiloes/{id_solicitacao} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://br-consignado-gw.sandbox.lerian.net/v1/consignado/preleilao/leiloes/{id_solicitacao}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://br-consignado-gw.sandbox.lerian.net/v1/consignado/preleilao/leiloes/{id_solicitacao}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://br-consignado-gw.sandbox.lerian.net/v1/consignado/preleilao/leiloes/{id_solicitacao}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "closedAt": "2026-11-04T15:06:00Z",
  "cotacoes": [
    {
      "fundoRef": "fundo-a",
      "id": "0198f2c1-0000-7000-8000-0000000000a2",
      "idSolicitacao": "18406",
      "motivo": "sem_capacidade",
      "numeroParcelas": 12,
      "numeroPropostaComGarantia": "3W5X2Y4Z7K9M2P4R6T8V",
      "numeroPropostaSemGarantia": "7K9M2P4R6T8V3W5X2Y4Z",
      "originadorRef": "originador-a",
      "railCodigo": "BL",
      "rank": 1,
      "receivedAt": "2026-11-04T15:03:21Z",
      "reserva": {
        "status": "reserved",
        "valorConfirmado": "1000.00",
        "valorReservado": "1000.00"
      },
      "resolvedAt": "2026-11-04T15:10:04Z",
      "revisao": 1,
      "revisoes": [
        {
          "numeroParcelas": 12,
          "receivedAt": "2026-11-04T15:03:21Z",
          "revisao": 1,
          "valorCetAnual": "30.50",
          "valorCetMensal": "2.20",
          "valorLiberado": "1000.00",
          "valorParcela": "150.00"
        }
      ],
      "status": "received",
      "valorCetAnual": "30.50",
      "valorCetMensal": "2.20",
      "valorLiberado": "1000.00",
      "valorParcela": "150.00"
    }
  ],
  "criterio": "cet_anual",
  "dataHoraValidadeSolicitacao": "2026-11-04T18:00:00Z",
  "discoveredAt": "2026-11-04T15:00:00Z",
  "fechamento": "prazo",
  "fundoPreferidoRef": "fundo-a",
  "idSolicitacao": "18406",
  "outcome": "accepted",
  "participantes": [
    {
      "fundoRef": "fundo-a",
      "originadorRef": "originador-a",
      "respondeuAt": "2026-11-04T15:03:21Z",
      "resposta": "cotou"
    }
  ],
  "prazoCotacao": "2026-11-04T15:10:00Z",
  "rodizio": {
    "faixaCetMensalBps": 15
  },
  "rodizioCalculo": {
    "faixaCetMensalBps": 15
  },
  "status": "open"
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

GET

consignado

preleilao

leiloes

{id_solicitacao}

Get a pre-auction auction

curl --request GET \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/consignado/preleilao/leiloes/{id_solicitacao} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://br-consignado-gw.sandbox.lerian.net/v1/consignado/preleilao/leiloes/{id_solicitacao}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://br-consignado-gw.sandbox.lerian.net/v1/consignado/preleilao/leiloes/{id_solicitacao}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://br-consignado-gw.sandbox.lerian.net/v1/consignado/preleilao/leiloes/{id_solicitacao}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "closedAt": "2026-11-04T15:06:00Z",
  "cotacoes": [
    {
      "fundoRef": "fundo-a",
      "id": "0198f2c1-0000-7000-8000-0000000000a2",
      "idSolicitacao": "18406",
      "motivo": "sem_capacidade",
      "numeroParcelas": 12,
      "numeroPropostaComGarantia": "3W5X2Y4Z7K9M2P4R6T8V",
      "numeroPropostaSemGarantia": "7K9M2P4R6T8V3W5X2Y4Z",
      "originadorRef": "originador-a",
      "railCodigo": "BL",
      "rank": 1,
      "receivedAt": "2026-11-04T15:03:21Z",
      "reserva": {
        "status": "reserved",
        "valorConfirmado": "1000.00",
        "valorReservado": "1000.00"
      },
      "resolvedAt": "2026-11-04T15:10:04Z",
      "revisao": 1,
      "revisoes": [
        {
          "numeroParcelas": 12,
          "receivedAt": "2026-11-04T15:03:21Z",
          "revisao": 1,
          "valorCetAnual": "30.50",
          "valorCetMensal": "2.20",
          "valorLiberado": "1000.00",
          "valorParcela": "150.00"
        }
      ],
      "status": "received",
      "valorCetAnual": "30.50",
      "valorCetMensal": "2.20",
      "valorLiberado": "1000.00",
      "valorParcela": "150.00"
    }
  ],
  "criterio": "cet_anual",
  "dataHoraValidadeSolicitacao": "2026-11-04T18:00:00Z",
  "discoveredAt": "2026-11-04T15:00:00Z",
  "fechamento": "prazo",
  "fundoPreferidoRef": "fundo-a",
  "idSolicitacao": "18406",
  "outcome": "accepted",
  "participantes": [
    {
      "fundoRef": "fundo-a",
      "originadorRef": "originador-a",
      "respondeuAt": "2026-11-04T15:03:21Z",
      "resposta": "cotou"
    }
  ],
  "prazoCotacao": "2026-11-04T15:10:00Z",
  "rodizio": {
    "faixaCetMensalBps": 15
  },
  "rodizioCalculo": {
    "faixaCetMensalBps": 15
  },
  "status": "open"
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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"
  }
}

{
  "code": "AUT-0033",
  "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.

Parámetros de ruta

id_solicitacao

string

requerido

The solicitação the auction belongs to.

Required string length: 1 - 19

Pattern: ^[1-9][0-9]{0,18}$

Ejemplo:

"18406"

Respuesta

closedAt

string<date-time> | null

requerido

When the window closed early; null while it runs to the deadline.

Ejemplo:

"2026-11-04T15:06:00Z"

cotacoes

object[]

requerido

The quotes by election rank, then arrival.

Show child attributes

criterio

enum<string>

requerido

The election criterion copied from the configuration at opening.

Opciones disponibles:

cet_anual,

parcela,

prazo

Ejemplo:

"cet_anual"

dataHoraValidadeSolicitacao

string<date-time>

requerido

Validity of the solicitation, UTC.

Ejemplo:

"2026-11-04T18:00:00Z"

discoveredAt

string<date-time>

requerido

When the gateway discovered the solicitation, UTC.

Ejemplo:

"2026-11-04T15:00:00Z"

fechamento

enum<string>

requerido

What closes the window: the deadline only, or every participant having answered.

Opciones disponibles:

prazo,

todos_responderam

Ejemplo:

"prazo"

fundoPreferidoRef

string | null

requerido

The preferred fund copied at opening; null when there is none.

Ejemplo:

"fundo-a"

idSolicitacao

string

requerido

The solicitation the auction belongs to.

Ejemplo:

"18406"

outcome

string | null

requerido

How the auction resolved; null until it does.

Ejemplo:

"accepted"

participantes

object[]

requerido

Expected participants; only when the auction closes on all answers.

Show child attributes

prazoCotacao

string<date-time>

requerido

Deadline of the quote window, UTC.

Ejemplo:

"2026-11-04T15:10:00Z"

rodizio

object | null

requerido

The rotation copied at opening; null when there is none.

Show child attributes

rodizioCalculo

object | null

requerido

The rotation's computation in this auction's election; null before the election.

Ejemplo:

{ "faixaCetMensalBps": 15 }

status

enum<string>

requerido

Where the auction is.

Opciones disponibles:

open,

submitting,

resolved

Ejemplo:

"open"

Configuración del tenant y credenciales

Datos del trabajador y margen

Subastas y propuestas

Configuración de la presubasta

Fondos de la presubasta

Subastas y cotizaciones de la presubasta

Registro y documentos del contrato

Correcciones del contrato

Ciclo de vida del contrato

Refinanciación, renegociación y portabilidad

Contratos legados

Garantías del FGTS

Conciliación y calendario

Fondos y cesiones

Acceso de socio del fondo

Acceso de socio del originador

Acceso de socio del originador (credencial vinculada)

Capacidad

Monitoreo

Suscripciones de eventos

Manejo de errores

Eventos

Get a pre-auction auction

Autorizaciones

Parámetros de ruta

Respuesta