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

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Path Parameters

id_solicitacao

string

required

The solicitação the auction belongs to.

Required string length: 1 - 19

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

Example:

"18406"

Response

closedAt

string<date-time> | null

required

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

Example:

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

cotacoes

object[]

required

The quotes by election rank, then arrival.

Show child attributes

criterio

enum<string>

required

The election criterion copied from the configuration at opening.

Available options:

cet_anual,

parcela,

prazo

Example:

"cet_anual"

dataHoraValidadeSolicitacao

string<date-time>

required

Validity of the solicitation, UTC.

Example:

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

discoveredAt

string<date-time>

required

When the gateway discovered the solicitation, UTC.

Example:

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

fechamento

enum<string>

required

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

Available options:

prazo,

todos_responderam

Example:

"prazo"

fundoPreferidoRef

string | null

required

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

Example:

"fundo-a"

idSolicitacao

string

required

The solicitation the auction belongs to.

Example:

"18406"

outcome

string | null

required

How the auction resolved; null until it does.

Example:

"accepted"

participantes

object[]

required

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

Show child attributes

prazoCotacao

string<date-time>

required

Deadline of the quote window, UTC.

Example:

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

rodizio

object | null

required

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

Show child attributes

rodizioCalculo

object | null

required

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

Example:

{ "faixaCetMensalBps": 15 }

status

enum<string>

required

Where the auction is.

Available options:

open,

submitting,

resolved

Example:

"open"

Tenant setup and credentials

Worker data and margin

Auctions and proposals

Pre-auction configuration

Pre-auction funds

Pre-auction auctions and quotes

Contract registration and documents

Contract corrections

Contract lifecycle

Refinancing, renegotiation, and portability

Legacy contracts

FGTS guarantees

Reconciliation and calendar

Funds and assignments

Fund partner access

Originador partner access

Originador partner access (bound credential)

Capacity

Monitoring

Event subscriptions

Error handling

Events

Get a pre-auction auction

Authorizations

Path Parameters

Response