List forgotten badge reports

QA Environment

https://qa-api.kiolinkapp.com

GET

/v1/forgotten-badge/start/{start_date}/end/{end_date}

Forgotten Badges

Last modified:2026-10-05 22:38:30

Maintainer:Not configured

Required Permission(s):badges-items-export

Returns every forgotten badge report in a date range, newest first.

Date range (on fecha_extravio), with undefined meaning "not sent":

Both undefined: the last month, up to today at 00:00 UTC (reports dated today are left out).

Only start_date: from that date on.

Only end_date: up to the end of that day.

Both: from start_date to the end of end_date. end_date before start_date returns HTTP 400.

Requires a session token whose role has the badges-items-export permission.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

authorization: ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://qa-api.kiolinkapp.com/v1/forgotten-badge/start/2026-09-01/end/2026-10-05' \
--header 'authorization: <api-key>'

Responses

🟢200Reports

application/json

Reports.

Bodyapplication/json

Example

{
    "data": [
        {
            "_id": "65f1c2a9e4b0a1b2c3d4e8b1",
            "nombre": "José María Esparza Arévalo",
            "num_empleado": 102345,
            "area": "Tecnología",
            "departamento": "Developer",
            "ceco": "CC-1020",
            "badge_id": "B-55821",
            "fecha_extravio": "2026-10-05T00:00:00.000Z",
            "detalles": "Olvidé el gafete en casa.",
            "created_at": "2026-10-05T15:30:00.000Z",
            "_user": "65f1c2a9e4b0a1b2c3d4e5e7",
            "_user_request": "65f1c2a9e4b0a1b2c3d4e5e7",
            "__v": 0
        }
    ]
}

🟠400`end_date` is before `start_date`

🟠401The session token expired

🟠403Not authenticated (missing/invalid token, inactive user), or

🔴500Unexpected error (e

Modified at 2026-10-05 22:38:30

Overview

List my forgotten badge reports