get
https://api.caas.staging.bancocdc.com.br/ect/leads/reservar
Reserves a batch of active leads to your project for the reservation TTL. Returns the leads plus a cota block describing your per-minute quota state.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
The response returns only the partner-facing fields listed in the table below.
Quota exhausted (200, reservados: 0) — when your per-minute quota is spent,
reservados is 0 and cota.janela_reinicia_em_segundos tells you when to retry.
Example with a 600/min limit: a first call asking 500 returns 500; a second call
asking 500 returns only 100 (quota now 0); a third returns 0 until the minute rolls.
cota block
| Field | Description |
|---|---|
limite_por_minuto | Your per-minute lead quota. |
consumido_na_janela | Leads delivered to you in the current clock-minute. |
restante_na_janela | Leads still available to you this minute. |
janela_reinicia_em_segundos | Seconds until the minute rolls and the quota resets. |
lead object (fields in data.data[])
| Field | Type | Description |
|---|---|---|
hash | string (uuid) | Public lead identifier (use it to fetch lead detail). |
id_dataprev | string (int) | Dataprev request id. This is the idSolicitacaoProposta you send back in a counter-proposal. |
cpf | string | Worker CPF. |
nome_trabalhador | string | Worker full name. |
data_nascimento | date Y-m-d | Birth date. |
matricula | string | Employment registration. |
inscricao_empregador_codigo | string | Employer registration type code. |
inscricao_empregador_descricao | string | Employer registration type (e.g. CNPJ). |
numero_inscricao_empregador | string | Employer registration number. |
data_admissao | date Y-m-d | Hire date. |
valor_liberado | decimal string | Amount available for the loan. |
nro_parcelas | string (int) | Number of installments offered. |
data_hora_validade_solicitacao | datetime | Request validity deadline. |
margem_disponivel | decimal string | Available margin. |
elegivel_emprestimo | Y/N | Loan-eligible. |
pessoa_exposta_politicamente_codigo | string | PEP code. |
pessoa_exposta_politicamente_descricao | string | PEP description. |
tem_garantias | Y/N | Whether the lead has an FGTS guarantee. Drives the temGarantias flag you must send. |
valor_saldo_disponivel_garantia_fgts | decimal string | null | FGTS available balance (null when no guarantee). |
valor_multa_rescisoria_garantia_fgts | decimal string | null | FGTS termination penalty (null when no guarantee). |
perc_verba_rescisoria_garantia | decimal string | null | Termination allowance % (null when no guarantee). |
status | string | Lead status — reservado when delivered to you. |
expires_at | datetime | When the lead itself expires (Dataprev validity). |
reservado_ate | datetime | When your reservation expires and the lead returns to the pool. |