API Pública da Vitrine

Integre o estoque de cotas contempladas da C1 ao seu site ou sistema. A API é pública (sem autenticação), somente leitura, e retorna apenas cotas publicadas — os dados sensíveis nunca são expostos.

Base URL: https://c1contemplados.com.br/api

Formato: JSON · Método: somente GET (leitura) · Autenticação: não exigida

Limite de uso: 120 requisições por minuto por IP. Acima disso, a API responde 429.

Valores monetários em reais (número decimal) · datas no formato YYYY-MM-DD.

GET/vitrine/cotas

Lista todas as cotas contempladas publicadas na vitrine. Aceita filtros opcionais via query string.

Filtros (query string)

Parâmetro	Tipo	Descrição
segmento	enum	IMOVEL · AUTO · SERVICO · OUTROS
administradora	texto	Busca parcial pelo nome da administradora
creditoMin / creditoMax	número	Faixa do valor do crédito (R$)
entradaMin / entradaMax	número	Faixa do valor da entrada (R$)
origemEstoque	enum	PROPRIO · TERCEIROS

Exemplo

curl "https://c1contemplados.com.br/api/vitrine/cotas?segmento=IMOVEL&creditoMin=300000&creditoMax=800000"

Resposta (resumo dos campos)

[
  {
    "id": "cmq6yp01y00bp...",          // id interno (use nos endpoints /cotas/:id)
    "codigoRef": "xdi565",             // código público curto — cite em contatos
    "administradora": "MYCON",
    "segmento": "IMOVEL",
    "valorCredito": 498123.55,         // crédito já corrigido até a data de hoje
    "valorEntrada": 211500.00,
    "quantidadeParcelas": 171,
    "valorParcela": 3426.63,
    "saldoDevedor": 540265.13,
    "proximoVencimento": "2026-07-08",
    "situacao": "CONTEMPLADO",
    "status": "DISPONIVEL",               // DISPONIVEL | RESERVADA
    "origemEstoque": "PROPRIO",           // PROPRIO | TERCEIROS
    "empresa": { "nome": "C1 Contemplados", "slug": "c1" }
  }
]

GET/vitrine/cotas/:id

Detalhe de uma cota publicada (mesmos campos da listagem).

curl "https://c1contemplados.com.br/api/vitrine/cotas/cmq6yp01y00bp1205fvt9a259"

GET/vitrine/grupos

Resumo do estoque disponível agrupado por administradora e segmento — útil para montar filtros.

curl "https://c1contemplados.com.br/api/vitrine/grupos"

// Resposta:
[
  { "administradora": "MYCON", "segmento": "IMOVEL", "total": 12, "totalCredito": 4830500.00 }
]

POST/vitrine/combinar

Motor de combinações: encontra junções de cotas que somam o crédito alvo (mesma administradora e segmento). Único endpoint POST público.

curl -X POST "https://c1contemplados.com.br/api/vitrine/combinar" \
  -H "Content-Type: application/json" \
  -d '{
    "administradora": "MYCON",
    "segmento": "IMOVEL",
    "creditoAlvo": 1000000,
    "margem": 3
  }'

// Resposta: { melhorCredito, menorEntrada, menorParcela }
// Cada um traz as cotas da junção (com codigoRef), totais e a mensagem
// pronta para WhatsApp com os IDs das cotas ao final.

Código de referência (codigoRef)

Cada cota tem um código público curto de 6 caracteres (ex.: xdi565). Como podem existir cotas com valores idênticos no estoque, sempre cite o codigoRef ao entrar em contato sobre uma cota ou junção — ele identifica a cota de forma inequívoca. As mensagens de WhatsApp geradas pelo portal já incluem os códigos automaticamente.

Dúvidas ou precisa de algo além da leitura?

Fale com a gente: contato@c1contemplados.com.br