| Parámetros | Descripción | Longitud | Ejemplo |
|---|---|---|---|
| apikey | Llave de autorización para uso de los Servicios Web. | 50 | 25sdsd234234aa93sdsdsd37c70118e72 |
| token | Token devuelto por el método [**getToken**](https://docs.redgps.com/books/webservice/page/metodo-de-autenticacion-gettoken-7ef). | 500 | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
| equipo | IMEI o Identificador único del dispositivo configurado en la plataforma. | 200 | 0580012342332337 |
| fechaIni | Fecha Inicial de los datos. | 19 | 2021-04-27 00:00:00 |
| fechaFin | Fecha Final de los datos. | 19 | 2021-04-27 23:59:59 |
| format | Si se pasan horas en **fechaIni** y **fechaFin** debe enviar “**DateTime**”, de lo contrario utilice “**Date**”. | 8 | DateTime |
| idsEvents | Se específica un o muchos Id de los eventos a consultar, separados por coma sin espacios. Si no se especifican se obtienen todos los eventos que no sean ubicación. | 1321,1322,1323,1324,1325,1326,1336, 1337,1338,1339 |
| Campo | Descripción | Formato |
|---|---|---|
| equipo | Número de serie o IMEI que permite identificar el dispositivo. | Entero |
| latitud | Latitud de la posición del vehículo. | Grados decimales |
| longitud | Longitud de la posición del vehículo. | Grados decimales |
| idstatus | Status de la información que reportó el equipo: 1 = Información actual 2 = Información a futuro. | Entero |
| gmt | Greenwich Mean Time. | Cadena de texto |
| fecha | Fecha de la posición del vehículo. | DateTime |
| hora | Hora de la posición del vehículo. | HH::MM:SS |
| fecha\_reporte | Fecha y hora de la posición del vehículo. | Timestamp |
| idevento | Identificador del evento que reportó el equipo GPS. | Entero |
| velocidad | Velocidad en km/h que detecta el equipo GPS. | Entero |
| orientacion | Orientación en grados en la que reportó el equipo GPS. | Entero |
| senal | Señal GSM del equipo GPS. | Entero |
| satelites | Cantidad de satélites. | Entero |
| inputs | Estados de cada entrada del equipo: 0 = Desactivada 1 = Activada | Cadena de texto |
| odometro | Metros (mts) que ha recorrido el vehículo, detectado por el GPS. | Entero |
| bateria\_gps | Porcentaje o voltaje del nivel de la batería interna del GPS. | Entero | Decimales |
| bateria\_veh | Voltaje (v) de la batería del vehículo. | Decimales |
| ignicion | Status Ignición: 0 = OFF 1 = ON 2 = Desconocida | Entero |
| IdConductor | Id del conductor autentificado, Ibutton | Entero |
| domicilio | Domicilio. | Cadena de texto |
| de\_buffer | Status del tipo de reporte: 0 = Sin Buffer 1 = Buffer | Entero |
| datos\_extras | Valores que son obtenidos del protocolo OBDII. | JSON |
| grupo | Nombre del grupo que pertenece. | Cadena de texto |
| conductor | Nombre del conductor. | Cadena de texto |
| patente | Nombre de la patente. | Cadena de texto |
| activo | Nombre del activo. | Cadena de texto |
| Parámetros | Descripción | Longitud | Ejemplo |
|---|---|---|---|
| apikey | **(Requerido)** Llave de autorización para uso de los Servicios Web. | 50 | 25sdsd234234aa93sdsdsd37c70118e72 |
| token | **(Requerido)** Token devuelto por el método getToken. | 500 | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
| equipo | **(Requerido)** IMEI o Identificador único del dispositivo configurado en la plataforma. | 200 | 0580012342332337 |
| fechaIni | **(Requerido)** Fecha Inicial de los datos. | 19 | 2023-03-08 00:00:00 |
| fechaFin | **(Requerido)** Fecha Final de los datos. | 19 | 2023-03-08 23:59:59 |
| format | **(Requerido)** Si se pasan horas en **fechaIni** y **fechaFin** debe enviar “DateTime”, de lo contrario utilice “Date”. | 8 | DateTime |
| limite | **(Opcional)** Permite establecer un límite de filas de datos a recibir del WS, si no especifica un límite se regresan todos los datos. | 1 |
**Nota:** El limite máximo para consultar datos históricos es de 15 días por equipo.
##### Solicitud de ejemplo: ```shell curl --location --request POST 'https://api.service24gps.com/api/v1/history/get' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \ --form 'equipo="0580012342332337"' \ --form 'fechaIni="2023-03-08 00:00:00"' \ --form 'fechaFin="2023-03-08 23:59:59"' \ --form 'format="DateTime"' \ --form 'limite="1"' ``` ##### Respuesta de ejemplo: ```JSON { "status": 200, "data": { "equipo": "0580012342332337", "latitud": "+19.528530", "longitud": "-99.171165", "iporigen": "", "puerto": "", "idstatus": "1", "gmt": "-5", "fecha": "2023-03-08", "hora": "23:59:39", "fecha_reporte": "20230308235939", "idevento": "1", "velocidad": "0", "orientacion": "0", "senal": "65", "satelites": "20", "inputs": "0|0|0|0|0|0|0|0|0|0|0|0|0|0|0", "odometro": "57373562", "bateria_gps": "100", "bateria_veh": "13.83", "ignicion": "1", "idconductor": "0", "domicilio": "Camino a San Juan Ixtacala 479, San Juan, Gustavo A. Madero, Mexico City, Mexico", "de_buffer": "0", "datos_extras": "{\"parameters\":{\"out_1\":\"0\",\"out_2\":\"0\",\"out_3\":\"0\",\"out_4\":\"0\",\"out_5\":\"0\",\"out_6\":\"0\",\"out_7\":\"0\",\"out_8\":\"0\"},\"outputs\":\"0|0|0|0|0|0|0|0\",\"Time_stamp_insert\":\"20210427201542\",\"tipo_dato\":{\"1\":\"2021-04-28 01:15:42\",\"13\":\"2021-04-27 21:04:29\",\"55\":\"2021-04-27 21:04:30\",\"14\":\"2021-04-27 21:05:42\",\"3\":\"2021-04-27 21:03:42\"},\"gw\":\"Escuchar-ST4340-TCP.php\",\"ip\":\"107.170.254.11\",\"kp\":\"6088b73e3a7f5\"}", "grupo": "Flota 1", "conductor": "", "patente": "ABC-813", "activo": "Activo-01" } } ```| Campo | Descripción | Formato | |
|---|---|---|---|
| equipo | Número de serie o IMEI que permite identificar el dispositivo. | Entero | |
| latitud | Latitud de la posición del vehículo. | Grados decimales | |
| longitud | Longitud de la posición del vehículo. | Grados decimales | |
| iporigen | Ip de origen de reporte del equipo GPS. | Cadena de texto | |
| puerto | Puerto de origen de reporte del equipo GPS. | Entero | |
| idstatus | Status de la información que reportó el equipo: 1 = Información actual 2 = Información a futuro. | Entero | |
| gmt | Greenwich Mean Time. | Cadena de texto | |
| fecha | Fecha | aaaa-mm-dd | |
| hora | Hora | hh:mm:ss | |
| fecha\_reporte | Fecha hora de la posición del vehículo. | DateTime | |
| idevento | Identificador del evento que reportó el equipo GPS. | Entero | |
| velocidad | Velocidad en km/h que detecta el equipo GPS. | Entero | |
| orientacion | Orientación en grados en la que reportó el equipo GPS. | Entero | |
| senal | Señal GSM del equipo GPS. | Entero | |
| satelites | Cantidad de satélites. | Entero | |
| inputs | Estados de cada entrada del equipo: 0 = Desactivada 1 = Activada | Cadena de texto | |
| odometro | Metros (mts) que ha recorrido el vehículo, detectado por el GPS. | Entero | |
| bateria\_gps | Porcentaje o voltaje del nivel de la batería interna del GPS. | Entero | Decimales | |
| bateria\_veh | Voltaje (v) de la batería del vehículo. | Decimales | |
| ignicion | Status Ignición: 0 = OFF 1 = ON 2 = Desconocida | Entero | |
| IdConductor | Id del conductor autentificado, Ibutton | Entero | |
| de\_buffer | Status del tipo de reporte: 0 = Sin Buffer 1 = Buffer | Entero | |
| datos\_extras | Valores que son obtenidos del protocolo OBDII. | JSON | |
| grupo | Nombre del grupo | Cadena de texto | |
| conductor | Nombre del conductor | Cadena de texto | |
| patente | Patente del activo | Cadena de texto | |
| activo | Nombre del activo | Cadena de texto |
| **Parámetros** | **Descripción** | **Ejemplo** |
| apikey | Llave de autorización para uso de los Servicios Web. | 25sdsd234234aa93sdsdsd37c70118e72 |
| token | Token devuelto por el método getToken. | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
| Parámetros | Descripción | Ejemplo |
|---|---|---|
| apikey | **(Requerido)** Llave de autorización para uso de los Servicios Web. | 25sdsd234234aa93sdsdsd37c70118e72 |
| token | **(Requerido)** Token devuelto por el método [**getToken**](https://docs.redgps.com/books/webservice/page/metodo-de-autenticacion-gettoken/es). | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
| idgrupo | **(Opcional)** Identificador único del grupo de Activos. Este parámetro tiene prioridad sobre **equipo;** si se especifica, la consulta se realizará para los Activos pertenecientes al grupo indicado. Para obtener los identificadores disponibles, consulte el método **[getAssetGroups.](https://docs.redgps.com/books/webservice/page/listado-de-grupo-de-activos-getassetgroups/es)** **Nota:** Si se desea realizar la consulta únicamente para un equipo, este parámetro debe enviarse vacío. | 45665 |
| equipo | **(Requerido)** IMEI del equipo del cual se desean obtener las alertas. Este parámetro será considerado únicamente cuando **idgrupo** no se especifique. | 354148072188807 |
| fecha\_inicio | **(Requerido)** Fecha de inicio del rango para la consulta de alertas. | 2026-08-01 |
| fecha\_fin | **(Requerido)** Fecha de fin del rango para la consulta de alertas. | 2026-08-14 |
Si los parámetros **idgrupo** y **equipo** se envían vacíos, la consulta devolverá las alertas de todos los Activos asociados al usuario.
Si ambos campos de fecha se dejan vacíos, la consulta se realizará para el día actual.
Solo es posible consultar rangos de hasta **14 días**.
##### Solicitud de ejemplo: ```shell curl --location 'https://api.service24gps.com/api/v1/getAlerts' \ --form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \ --form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \ --form 'idgrupo="45665"' \ --form 'equipo="354148072188807"' \ --form 'fecha_inicio="2026-08-01"' \ --form 'fecha_fin="2026-08-14"' ``` ##### Respuesta de ejemplo: ```JSON { "status": 200, "data": { "Equipo": "354148072188807", "Fecha": "2026-08-10", "Hora": "08:16:16", "Descripcion": "Unidad Generó BOTON DE PANICO el 2022/02/24 08:16:16| Campo | Descripción | Formato | |
|---|---|---|---|
| Equipo | Equipo asignado al vehículo que ejecutó la alerta. | Cadena de Texto | |
| Fecha | Fecha en la que la alerta se ejecutó. | DateTime | |
| Hora | Hora de la alerta (se maneja en formato de 24 hrs.) | DateTime | |
| Descripción | Texto descriptivo de la alerta. | Cadena de Texto | |
| Latitud | Latitud correspondiente al punto en que se originó la alerta. | Cadena de Texto | |
| Longitud | Longitud correspondiente al punto en que se originó la alerta. | Cadena de Texto | |
| Domicilio | Dirección correspondiente a la latitud y longitud reportada por el equipo. | Cadena de Texto | |
| StatusAlerta | Nombre del estado del alerta, puede ser los siguientes: - IGNICIÓN ON - IGNICIÓN OFF - DENTRO DE LA GEOCERCA - FUERA DE LA GEOCERCA - TEMPERATURA LIMITE INFERIOR - TEMPERATURA LIMITE SUPERIOR | Cadena de Texto | |
| TipoAlerta | Nombre del tipo de alerta que se generó. | Cadena de Texto |
| Parámetros | Descripción | Longitud | Ejemplo |
|---|---|---|---|
| apikey | Llave de autorización para uso de los Servicios Web. | 50 | 25sdsd234234aa93sdsdsd37c70118e72 |
| token | Token devuelto por el método getToken. | 500 | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
| Campo | Descripción | Formato |
|---|---|---|
| id | Identificador único del evento en el sistema. | Entero |
| nombre | Nombre del evento | Texto |
| Parámetros | Descripción | Longitud | Ejemplo |
|---|---|---|---|
| apikey | Llave de autorización para uso de los Servicios Web. | 50 | 25sdsd234234aa93sdsdsd37c70118e72 |
| token | Token devuelto por el método **[getToken](https://docs.redgps.com/books/webservice/page/metodo-de-autenticacion-gettoken-7ef)**. | 500 | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
| Campo | Descripción | Formato |
|---|---|---|
| id | Identificador único del sensor. | Entero |
| nombre | Nombre del sensor | Texto |