Consultar los movimientos de monedas de todos tus conductores

[ GET ]

Consulta los movimientos (abonos y cargos) de monedas registrados para todos los conductores de tu empresa dentro de un rango de fechas.

https://sync.airbagtech.io/coins/company

Valores de datos

type

Filtra los movimientos por razón. Los valores aceptados son los listados como canónicos en Monedas › Razones de ajuste de monedas (trip, daily-bonus, prizes, referral, challenges, etc.).

Campos

Nombre	Tipo	Requerido	Descripción
startDate	String	Sí	Fecha de inicio de la consulta (inclusive). Formato ISO 8601.
endDate	String	Sí	Fecha de fin de la consulta (inclusive). Formato ISO 8601.
type	String	No	Filtra los movimientos por razón. Valores soportados: los listados en la tabla anterior.
limit	Number	No	Número máximo de registros a regresar. Valor por defecto: 30.

Headers

Content-Type	Autorization
application/json	apikey {{API_KEY}}

Ejemplo

curl --location 'https://sync.airbagtech.io/coins/company' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: apikey {{API_KEY}}' \
  --data 'type=trip&startDate=2025-02-01&endDate=2025-02-28&limit=30'

Respuestas

✅ Respuesta exitosa (200 OK)

Devuelve el número total de movimientos devueltos (count) y un arreglo data con cada movimiento de monedas ordenado del más reciente al más antiguo. Cada movimiento incluye el saldo antes (oldCoins) y después (newCoins) del ajuste, permitiendo reconstruir el histórico de balance.

{
  "status": true,
  "count": 30,
  "data": [
    {
      "internalId": null,
      "driverName": "Ana Martínez",
      "created": "2025-02-16T20:06:09.133Z",
      "oldCoins": 55,
      "newCoins": 56,
      "type": "trip",
      "value": 1
    },
    {
      "internalId": null,
      "driverName": "Ana Martínez",
      "created": "2025-02-16T13:25:50.688Z",
      "oldCoins": 51,
      "newCoins": 54,
      "type": "daily-bonus",
      "value": 3
    },
    {
      "internalId": "EMP-1042",
      "driverName": "Juan Pérez Ramírez",
      "created": "2025-02-15T13:26:54.246Z",
      "oldCoins": 523,
      "newCoins": 524,
      "type": "daily-bonus",
      "value": 1
    },
    {
      "internalId": "cust-fleet-a82f",
      "driverName": "Pamela Ruiz",
      "created": "2025-02-14T18:48:04.497Z",
      "oldCoins": 1875.6099999999997,
      "newCoins": 1407.6099999999997,
      "type": "prizes",
      "value": 468
    },
    {
      "internalId": null,
      "driverName": "Sayuri Tanaka",
      "created": "2025-02-14T03:04:12.291Z",
      "oldCoins": 22,
      "newCoins": 1022,
      "type": "referral",
      "value": 1000
    },
    {
      "internalId": null,
      "driverName": "Luis Contreras",
      "created": "2025-02-13T22:02:34.196Z",
      "oldCoins": 344,
      "newCoins": 544,
      "type": "prizes",
      "value": 200
    },
    {
      "internalId": null,
      "driverName": "Javier Ortega",
      "created": "2025-02-13T19:42:52.037Z",
      "oldCoins": 24760,
      "newCoins": 24761,
      "type": "trip",
      "value": 1
    }
    // … (resto de movimientos hasta completar los 30 elementos)
  ]
}

nota

• data contiene hasta limit elementos (por defecto 30). Si no hay coincidencias, data es un arreglo vacío ([]).
• Los movimientos de tipo prizes reducen el balance del conductor (newCoins < oldCoins). El resto de tipos lo incrementan (newCoins > oldCoins).

Descripción de campos de respuesta

Campo	Tipo	Descripción
status	Boolean	Indica si la operación fue exitosa.
count	Number	Número total de movimientos devueltos en data.
data	Array<Object>	Movimientos de monedas ordenados del más reciente al más antiguo. Ver tabla abajo.

Campos dentro de cada elemento de data

Campo	Tipo	Descripción
driverName	String	Nombre completo del conductor al que pertenece el movimiento.
internalId	String | null	ID del conductor proporcionado por la empresa al crearlo. Es null cuando el conductor no tiene un internalId asignado.
created	String	Fecha y hora del movimiento en formato ISO 8601 (UTC).
type	String	Razón del movimiento. Consulta la lista completa de valores en Monedas › Razones de ajuste de monedas.
value	Number	Cantidad absoluta de monedas involucradas en el movimiento. No lleva signo; usa oldCoins y newCoins para determinar la dirección (abono o cargo).
oldCoins	Number	Balance del conductor antes del movimiento.
newCoins	Number	Balance del conductor después del movimiento.