API

Consultar viajes y ganancias

Credikul ingiere los viajes y las ganancias de las plataformas y te los expone unificados. Tres endpoints, todos con scope rides:read:

Endpoint Granularidad
GET /v1/rides Por viaje
GET /v1/earnings/daily Por conductor × día
GET /v1/earnings/summary Totales del periodo

platform es requerido en todos — los datos de cada plataforma tienen forma y tiempos distintos.

Convenciones de datos

  • Dinero: siempre string decimal en MXN — "1523.50". Nunca hagas aritmética flotante con centavos: usa decimales.
  • Fechas: día calendario de CDMX (−06:00 fijo, sin horario de verano). from/to en formato YYYY-MM-DD, inclusivos.
  • didi: el detalle por viaje trae el cobro al pasajero (grossMxn) y desglose de propina; el ingreso neto del conductor se reporta a nivel diario (/earnings/daily), no por viaje.
  • indrive: cada viaje trae grossMxn (GMV) y netMxn; solo se reportan viajes completados.

Ejemplos

# Viajes didi de la semana, de un conductor
curl "https://api.credikul.com/v1/rides?platform=didi&from=2026-06-29&to=2026-07-05&driverId=9c4d…" \
  -H "Authorization: Bearer ck_live_TU_LLAVE"

# Ganancias diarias indrive del mes
curl "https://api.credikul.com/v1/earnings/daily?platform=indrive&from=2026-06-01&to=2026-06-30" \
  -H "Authorization: Bearer ck_live_TU_LLAVE"

# Totales del periodo
curl "https://api.credikul.com/v1/earnings/summary?platform=didi&from=2026-06-01&to=2026-06-30" \
  -H "Authorization: Bearer ck_live_TU_LLAVE"

Paginación

Las listas usan cursor: pide limit (máx. 100) y para la siguiente página pasa startingAfter=<id del último elemento>. La respuesta incluye hasMore.

{ "data": [ … ], "hasMore": true }

⚠️ Asentamiento de métricas

Los números no son definitivos el mismo día:

  • didi — tarifas, propinas y cancelaciones se ajustan durante ~2-3 días.
  • indrive — las métricas se asientan en ventanas de 1 a 16 días (viajes ~1 día, GMV/neto ~2, horas ~5, kilometraje hasta 16).

Para conciliación contable: re-consulta las ventanas recientes (los últimos 7 días de didi, los últimos 17 de indrive) antes de cerrar cifras. Credikul re-ingiere esas ventanas automáticamente cada día — tus consultas siempre reflejan lo último que la plataforma reportó.

Frescura

La ingesta corre a diario (más un refresco intradía para didi). Un viaje terminado hace minutos puede tardar unas horas en aparecer.