Build decarbonization into your product Construa descarbonização dentro do seu produto

Five modules, one integrationCinco módulos, uma integração

Pick what your product needs. Everything shares the same auth, idempotency and webhook layer. Use o que seu produto precisa. Tudo compartilha a mesma camada de autenticação, idempotência e webhooks.

Built for your verticalFeito para a sua vertical

The same platform powers five very different products. Find yours. A mesma plataforma alimenta cinco produtos bem diferentes. Encontre o seu.

Three ways in — with or without a tech teamTrês caminhos — com ou sem time técnico

In plain words: an API is a secure bridge that lets your systems and ours exchange data automatically. But you don't need one to start — pick the path that fits your team today and upgrade later. Em palavras simples: uma API é uma ponte segura que permite que os seus sistemas e os nossos troquem dados automaticamente. Mas você não precisa dela para começar — escolha o caminho que cabe no seu time hoje e evolua depois.

Three calls to your first credited tripTrês chamadas até o primeiro trajeto creditado

Sandbox with synthetic data before go-live. Target integration time: under one week. Sandbox com dados sintéticos antes do go-live. Meta de integração: menos de uma semana.

# Every sustainable kilometer becomes value
curl -X POST https://sandbox.api.ecomilhas.com/v1/trips \
  -H "X-Api-Key: $ECOMILES_KEY" \
  -H "Idempotency-Key: trip-0001" \
  -d '{
    "external_trip_id": "APP-TRIP-0001",
    "user_id": "usr_8a1b2c",
    "modal": "BICYCLE",
    "distance_km": 6.2,
    "started_at": "2026-07-30T08:02:00Z",
    "ended_at": "2026-07-30T08:31:00Z",
    "source": "SDK_AUTO"
  }'

# 201 → {"ecomiles_earned": 1.86, "co2e_avoided_kg": 0.97, "status": "PROCESSED"}

# Show it in your app
curl https://sandbox.api.ecomilhas.com/v1/users/usr_8a1b2c/balance \
  -H "X-Api-Key: $ECOMILES_KEY"

# 200 →
{
  "balance": 1250.5,
  "lifetime_earned": 4890.0,
  "co2e_avoided_kg_lifetime": 312.4
}

# GHG Protocol-structured export for ESG platforms
curl "https://sandbox.api.ecomilhas.com/v1/organizations/org_123/impact/export?format=ghg&period_start=2026-01-01&period_end=2026-06-30" \
  -H "X-Api-Key: $ECOMILES_KEY"

# 200 → scope / category / tCO2e entries, MRV-traceable to individual trips

Endpoints at a glanceEndpoints em resumo

REST, path-versioned (/v1), ISO 8601 dates, cursor pagination, Idempotency-Key support. Full schema in the OpenAPI spec. REST, versionamento por path (/v1), datas ISO 8601, paginação por cursor, suporte a Idempotency-Key. Schema completo na spec OpenAPI.

Supported modals:Modais suportados: WALK BICYCLE E_BIKE SCOOTER EV_MOTORCYCLE EV_CAR CARPOOL BUS RAIL METRO

React in real timeReaja em tempo real

HMAC-SHA256 signed (X-Ecomilhas-Signature), exponential-backoff retries for up to 24h. Assinados com HMAC-SHA256 (X-Ecomilhas-Signature), retry com backoff exponencial por até 24h.

Boring where it mattersSério onde importa

• OAuth 2.0 — client credentials for servers; "Connect with Ecomiles" authorization-code flow with granular scopes for end-user consent.client credentials para servidores; fluxo "Conectar com Ecomilhas" (authorization code) com escopos granulares para consentimento do usuário.
• LGPD / GDPR — data minimization, deletion propagation, organizations only ever see aggregates — never raw location.minimização de dados, propagação de exclusão, organizações só veem agregados — nunca localização bruta.
• Mastercard MDES — card provisioning through network standards; the PAN is never exposed to partners.provisioning do cartão pelos padrões da bandeira; o PAN nunca é exposto a parceiros.
• GHG Protocol + MRV — versioned emission factors per modal/region; every tCO2e traceable to its trips. Methodology with limited assurance by KPMG.fatores de emissão versionados por modal/região; cada tCO2e rastreável até seus trajetos. Metodologia com asseguração limitada KPMG.
• Anti-fraud — speed-vs-modal checks, spatio-temporal dedup, idempotency by external id.validação velocidade × modal, deduplicação espaço-temporal, idempotência por id externo.
• Rate limiting & sandbox — tiered quotas, full test environment before production keys.cotas por tier, ambiente de testes completo antes das chaves de produção.
• Hardened by default — TLS everywhere, strict security headers (CSP, X-Frame-Options, nosniff) on this portal, webhook HMAC signatures and secret rotation.TLS em tudo, security headers estritos (CSP, X-Frame-Options, nosniff) neste portal, assinaturas HMAC nos webhooks e rotação de segredos.
• Responsible disclosure — found a vulnerability? See security.txt or write to contato@ecomiles.app.encontrou uma vulnerabilidade? Veja o security.txt ou escreva para contato@ecomiles.app.

Where we areOnde estamos

The platform is in technical planning — no endpoint is live in production yet. Design partners shape the final scope with us. A plataforma está em planejamento técnico — nenhum endpoint está em produção ainda. Design partners definem o escopo final conosco.