AccessLogs
Gate and tap access records — when a student was checked in or out at a zone/location. List and filter the logs, export them, fetch rolled-up summaries, and undo an erroneously recorded access event.
GET List {{url}}/utility/access-logs ▸
Retrieves a paginated list of access logs — student tap-in / tap-out events at zones — for auditing and monitoring. Proxied from the WaaS partner system and re-paginated to TerraGo.
Query Parameters (all optional)
- status: filter by tap type —
Checked InorChecked Out. Leave it out (null / empty) to return all taps. - zone_type: filter by point type —
Mobile(a vehicle / bus) orFixed(a gate / access point). Leave it out (null / empty) to return all point types. - dependant_id (
stringUUID): filter to one student. - parent_id (
stringUUID): filter to one parent's children. - zone_id (
stringUUID): filter to one zone / location. - tags (array of tag uuids): filter by route / zone tags.
- date_range:
"YYYY-MM-DD HH:mm:ss, YYYY-MM-DD HH:mm:ss"(start,end). - search: free-text (student name).
- per_page (default 10, max 20), page.
Response
Paginated list of access-log entries (data) with meta pagination; each row is a student's check-in / check-out at a zone with a timestamp.
Auth
Bearer tokenUsed On
Request Body
{
// "tags": ["27ba6b10-c659-408f-beb1-dc650d5d5034", "5ac13004-3e77-4e9e-a9b8-be8080ce845e"],
// "dependant_id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f", // filter to one student
// "parent_id": "b3b62c15-1409-4713-81b2-d4f6744039e6", // filter to one parent's children
// "zone_id": "825e7402-a072-4926-9bfb-27280c2be5eb", // filter to one zone/location
// "date_range": "2025-04-23 14:03:21, 2025-05-23 14:03:21",
// "status": "Checked In", // "Checked In" or "Checked Out"; omit (null/empty) for all
// "zone_type": "Mobile", // "Mobile" (vehicle/bus) or "Fixed" (gate); omit (null/empty) for all
"search": "Lincoln Chege", // Free-text search (student name)
"per_page": 10, // Page size — how many results per page
"page": 1 // Page number (starts at 1)
}Sample Response (200 OK)
{
"data": [
{
"id": "929055eb-5e73-4563-855c-3a6b45391b07",
"code": "B20C4A9AKDQ",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
"name": "Lincoln Chege",
"metadata": {
"grade": "Grade 6"
}
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": {
"id": "b3b62c15-1409-4713-81b2-d4f6744039e6",
"name": "Francis Chege"
},
"checked_in_guardian": {
"id": "ba20fb10-c2c1-4951-9903-53c6fdbeabef",
"name": "Peter Chege"
},
"checked_out_guardian": {
"id": "ba20fb10-c2c1-4951-9903-53c6fdbeabef",
"name": "Peter Chege"
}
},
{
"id": "4eb7d2d4-ba6b-44cb-ae93-ea0d95572346",
"code": "B20C4A9AKDP",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
"name": "Lincoln Chege",
"metadata": {
"grade": "Grade 6"
}
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": {
"id": "b3b62c15-1409-4713-81b2-d4f6744039e6",
"name": "Francis Chege"
},
"checked_in_guardian": {
"id": "ba20fb10-c2c1-4951-9903-53c6fdbeabef",
"name": "Peter Chege"
},
"checked_out_guardian": {
"id": "ba20fb10-c2c1-4951-9903-53c6fdbeabef",
"name": "Peter Chege"
}
},
{
"id": "53ecd826-a60c-4aa4-8d15-ae46af183495",
"code": "B20C4A9AKDO",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "7b5f4ec6-8aad-4629-85ba-192b2be6d2f2",
"name": "Martin Nyaga",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "41932cfe-ee6d-43c5-9461-625b3f0c0d92",
"code": "B20C4A9AKDN",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": null,
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "87fce716-9893-4ed6-a9d9-d313a8dc3536",
"code": "B20C4A9AKDM",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "01f9a2d4-6fdb-4418-aa61-97b0d3157cd7",
"name": "Ziham Man",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "674d9e12-a10b-4bd8-8d38-38e40d5fb2c5",
"code": "B20C4A9AKDL",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "9357bc7d-b26b-4e28-8c75-46f8d4717c06",
"name": "Mwinyi Mwinyi",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "9c4c1b71-68fc-4397-be69-7c5e8edcd32c",
"code": "B20C4A9AKDK",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "01f9a2d4-6fdb-4418-aa61-97b0d3157cd7",
"name": "Ziham Man",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "814291d5-5396-4253-b77d-a8fbcbeeaab4",
"code": "B20C4A9AKDJ",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
"name": "Ben Ngovi",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "e5b761a8-dc83-4bf2-b858-36062f0ba7f4",
"code": "B20C4A9AKDI",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "9357bc7d-b26b-4e28-8c75-46f8d4717c06",
"name": "Mwinyi Mwinyi",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "187a4760-950e-4729-a21b-b34ee10e5977",
"code": "B20C4A9AKDH",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
"name": "Ben Ngovi",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
}
],
"links": {
"first": "http://localhost:8001/api/access-log?page=1",
"last": "http://localhost:8001/api/access-log?page=689",
"prev": null,
"next": "http://localhost:8001/api/access-log?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 689,
"links": [
{
"url": null,
"label": "« Previous",
"page": null,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=1",
"label": "1",
"page": 1,
"active": true
},
{
"url": "http://localhost:8001/api/access-log?page=2",
"label": "2",
"page": 2,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=3",
"label": "3",
"page": 3,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=4",
"label": "4",
"page": 4,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=5",
"label": "5",
"page": 5,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=6",
"label": "6",
"page": 6,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=7",
"label": "7",
"page": 7,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=8",
"label": "8",
"page": 8,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=9",
"label": "9",
"page": 9,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=10",
"label": "10",
"page": 10,
"active": false
},
{
"url": null,
"label": "...",
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=688",
"label": "688",
"page": 688,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=689",
"label": "689",
"page": 689,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=2",
"label": "Next »",
"page": 2,
"active": false
}
],
"path": "http://localhost:8001/api/access-log",
"per_page": 10,
"to": 10,
"total": 6887
},
"status": 200,
"message": "Tags Retrieved Successfully"
}
GET List (by Zone/Location) {{url}}/utility/access-logs ▸
Variant of [List] — the exact same access-logs listing, but scoped to a specific zoneid (a zone/location UUID, e.g. one returned by GET /utility/zones). Every other filter from List (status, zonetype, daterange, dependantid, parent_id, tags, search) still applies.
Retrieves a paginated list of access logs — student tap-in / tap-out events at zones — for auditing and monitoring. Proxied from the WaaS partner system and re-paginated to TerraGo.
Query Parameters (all optional)
- status: filter by tap type —
Checked InorChecked Out. Leave it out (null / empty) to return all taps. - zone_type: filter by point type —
Mobile(a vehicle / bus) orFixed(a gate / access point). Leave it out (null / empty) to return all point types. - dependant_id (
stringUUID): filter to one student. - parent_id (
stringUUID): filter to one parent's children. - zone_id (
stringUUID): filter to one zone / location. - tags (array of tag uuids): filter by route / zone tags.
- date_range:
"YYYY-MM-DD HH:mm:ss, YYYY-MM-DD HH:mm:ss"(start,end). - search: free-text (student name).
- per_page (default 10, max 20), page.
Response
Paginated list of access-log entries (data) with meta pagination; each row is a student's check-in / check-out at a zone with a timestamp.
Auth
Bearer tokenUsed On
Request Body
{
// "tags": ["27ba6b10-c659-408f-beb1-dc650d5d5034", "5ac13004-3e77-4e9e-a9b8-be8080ce845e"],
// "dependant_id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f", // filter to one student
// "parent_id": "b3b62c15-1409-4713-81b2-d4f6744039e6", // filter to one parent's children
"zone_id": "825e7402-a072-4926-9bfb-27280c2be5eb", // REQUIRED here: the zone/location UUID to filter by (e.g. from GET /utility/zones)
// "date_range": "2025-04-23 14:03:21, 2025-05-23 14:03:21",
// "status": "Checked In", // "Checked In" or "Checked Out"; omit (null/empty) for all
// "zone_type": "Mobile", // "Mobile" (vehicle/bus) or "Fixed" (gate); omit (null/empty) for all
"search": "Lincoln Chege", // Free-text search (student name)
"per_page": 10, // Page size — how many results per page
"page": 1 // Page number (starts at 1)
}Sample Response (200 OK)
{
"data": [
{
"id": "929055eb-5e73-4563-855c-3a6b45391b07",
"code": "B20C4A9AKDQ",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
"name": "Lincoln Chege",
"metadata": {
"grade": "Grade 6"
}
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": {
"id": "b3b62c15-1409-4713-81b2-d4f6744039e6",
"name": "Francis Chege"
},
"checked_in_guardian": {
"id": "ba20fb10-c2c1-4951-9903-53c6fdbeabef",
"name": "Peter Chege"
},
"checked_out_guardian": {
"id": "ba20fb10-c2c1-4951-9903-53c6fdbeabef",
"name": "Peter Chege"
}
},
{
"id": "4eb7d2d4-ba6b-44cb-ae93-ea0d95572346",
"code": "B20C4A9AKDP",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
"name": "Lincoln Chege",
"metadata": {
"grade": "Grade 6"
}
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": {
"id": "b3b62c15-1409-4713-81b2-d4f6744039e6",
"name": "Francis Chege"
},
"checked_in_guardian": {
"id": "ba20fb10-c2c1-4951-9903-53c6fdbeabef",
"name": "Peter Chege"
},
"checked_out_guardian": {
"id": "ba20fb10-c2c1-4951-9903-53c6fdbeabef",
"name": "Peter Chege"
}
},
{
"id": "53ecd826-a60c-4aa4-8d15-ae46af183495",
"code": "B20C4A9AKDO",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "7b5f4ec6-8aad-4629-85ba-192b2be6d2f2",
"name": "Martin Nyaga",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "41932cfe-ee6d-43c5-9461-625b3f0c0d92",
"code": "B20C4A9AKDN",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": null,
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "87fce716-9893-4ed6-a9d9-d313a8dc3536",
"code": "B20C4A9AKDM",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "01f9a2d4-6fdb-4418-aa61-97b0d3157cd7",
"name": "Ziham Man",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "674d9e12-a10b-4bd8-8d38-38e40d5fb2c5",
"code": "B20C4A9AKDL",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "9357bc7d-b26b-4e28-8c75-46f8d4717c06",
"name": "Mwinyi Mwinyi",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "9c4c1b71-68fc-4397-be69-7c5e8edcd32c",
"code": "B20C4A9AKDK",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "01f9a2d4-6fdb-4418-aa61-97b0d3157cd7",
"name": "Ziham Man",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "814291d5-5396-4253-b77d-a8fbcbeeaab4",
"code": "B20C4A9AKDJ",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
"name": "Ben Ngovi",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "e5b761a8-dc83-4bf2-b858-36062f0ba7f4",
"code": "B20C4A9AKDI",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "9357bc7d-b26b-4e28-8c75-46f8d4717c06",
"name": "Mwinyi Mwinyi",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
},
{
"id": "187a4760-950e-4729-a21b-b34ee10e5977",
"code": "B20C4A9AKDH",
"zone": "SAFARI-WALK",
"status": "Checked In",
"checkin_at": "Thu, Apr 24, 2025 5:19 PM",
"checkout_at": null,
"created_at": "Thu, Apr 24, 2025 5:19 PM",
"dependant": {
"id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
"name": "Ben Ngovi",
"metadata": null
},
"checked_in_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"checked_out_verified_by": {
"id": "47886d66-99b4-4fa0-8bf9-3bac67812f58",
"name": "Peter Chege"
},
"auth_by": null,
"checked_in_guardian": null,
"checked_out_guardian": null
}
],
"links": {
"first": "http://localhost:8001/api/access-log?page=1",
"last": "http://localhost:8001/api/access-log?page=689",
"prev": null,
"next": "http://localhost:8001/api/access-log?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 689,
"links": [
{
"url": null,
"label": "« Previous",
"page": null,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=1",
"label": "1",
"page": 1,
"active": true
},
{
"url": "http://localhost:8001/api/access-log?page=2",
"label": "2",
"page": 2,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=3",
"label": "3",
"page": 3,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=4",
"label": "4",
"page": 4,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=5",
"label": "5",
"page": 5,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=6",
"label": "6",
"page": 6,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=7",
"label": "7",
"page": 7,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=8",
"label": "8",
"page": 8,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=9",
"label": "9",
"page": 9,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=10",
"label": "10",
"page": 10,
"active": false
},
{
"url": null,
"label": "...",
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=688",
"label": "688",
"page": 688,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=689",
"label": "689",
"page": 689,
"active": false
},
{
"url": "http://localhost:8001/api/access-log?page=2",
"label": "Next »",
"page": 2,
"active": false
}
],
"path": "http://localhost:8001/api/access-log",
"per_page": 10,
"to": 10,
"total": 6887
},
"status": 200,
"message": "Tags Retrieved Successfully"
}
GET Export {{url}}/utility/access-logs/export ▸
Retrieves a paginated list of access logs from the system. This endpoint is useful for auditing and monitoring user or system activity.
Note: Additional filters (such as tags, daterange, status, dependantid, parent_id) may be supported if provided, but are optional.
Response
Confirmation the export was queued (data); the file (PDF/Excel) is generated asynchronously and emailed to the requester.
Auth
Bearer tokenUsed On
Request Body
{
// "tags": ["27ba6b10-c659-408f-beb1-dc650d5d5034", "5ac13004-3e77-4e9e-a9b8-be8080ce845e"],
"dependant_id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
// "parent_id": "b3b62c15-1409-4713-81b2-d4f6744039e6",
// "date_range": "2025-04-23 14:03:21, 2025-05-23 14:03:21",
// "status": "Checked In", //Checked Out or Denied
// "search": "Lincoln Chege",
"per_page": 10,
"page": 1
}Sample Response (200 OK)
{
"status": 200,
"data": "Data export initiated successfully",
"message": "success"
}
GET Summaries {{url}}/utility/access-logs/summaries ▸
Retrieves a paginated list of access logs from the system. This endpoint is useful for auditing and monitoring user or system activity.
Note: Additional filters (such as tags, daterange, status, dependantid, parent_id) may be supported if provided, but are optional.
Response
Aggregated access-log summary counts (data) for the selected period.
Auth
Bearer tokenUsed On
Request Body
{
// "tags": ["27ba6b10-c659-408f-beb1-dc650d5d5034", "5ac13004-3e77-4e9e-a9b8-be8080ce845e"],
// "dependant_id": "30a250fe-0cbe-4afb-bb48-606e5d8f887f",
// "parent_id": "b3b62c15-1409-4713-81b2-d4f6744039e6",
// "date_range": "2025-04-23 14:03:21, 2025-05-23 14:03:21",
// "status": "Checked In", //Checked Out or Denied
"search": "Lincoln Chege",
"per_page": 10,
"page": 1
}Sample Response (200 OK)
{
"status": 200,
"data": {
"checkins": 814,
"checkouts": 45,
"total": 859
},
"message": "Access Logs Summaries Retrieved Successfully"
}
POST Undo Access Log {{url}}/utility/access-logs/undo ▸
Correct a mistaken tap-in/tap-out event (e.g. a scanner misfire, or a child tapped in twice by accident). Reverses the access log in the the registry system and, if the tap was linked to an active trip, adjusts that trip's live occupancy counters and cancels any notification jobs that were queued because of the original tap.
Request Body
- accesslogid (
stringUUID, required): The access log entry to undo. - dependant_id (
stringUUID, required): The child the log belongs to. - trip_id (
stringUUID, optional): If the tap was associated with an active trip, pass it so occupancy counts can be corrected. - undologtype (
string, required): ExactlyChecked InorChecked Out— which side of the tap is being undone. - notes (
string, optional, max 255): Reason for the correction, for audit purposes.
Side Effects
- If
undologtypeisChecked In, decrements the trip's occupancy counters; ifChecked Out, increments them back. - Cancels any pending SMS/WhatsApp "your child has been picked up/dropped off" notifications that were queued for this tap.
Response
Empty data; message confirms the access-log entry was reversed.
Auth
Bearer tokenRequest Body
{
"access_log_id":"143cfeb5-8fb3-444e-9b32-a54d972dcb04",
"trip_id":"cb4a018b-0e0a-4f72-bc3d-33faa54c18ad",
"dependant_id": "12781a10-ef34-43c2-a6af-65c404494389",
"undo_log_type":"Checked Out", //only use: Checked In, Checked Out
"notes":"Undo Because of Reasons"
}Sample Response (500 Internal Server Error)
{
"status": 200,
"data": "Undo Access Log Executed Successfully",
"message": "success"
}