API Reference

Attendance Export

Read-only attendance export for external integrations.

GET/api/v1/attendance

Returns up to 100 most recent attendance records for the organization linked to your API key. Each record includes the attendee name, phone number, timestamp, and optionally a signed photo URL. Designed for syncing attendance data with external HR systems, dashboards, or reporting tools.

Authorization

Bearer Token Required

Include your API key in the Authorization header as Bearer attg_live_…

Headers

ParameterTypeRequiredDescription
AuthorizationstringrequiredBearer token using your API key. Format: `Bearer attg_live_…`

Query Parameters

ParameterTypeRequiredDescription
include_photosbooleanDefault: falseWhen `true`, each record includes a signed URL to the attendee's face photo. URLs expire after 1 hour.

Rate Limits

120 requests per 60s window per IP address.

Responses

Responses

Attendance records returned successfully.

{
  "ok": true,
  "data": [
    {
      "first_name": "Sarah",
      "last_name": "Ahmed",
      "phone_number": "+201234567890",
      "created_at": "2026-05-21T14:30:00Z",
      "status": "present",
      "face_picture": null
    }
  ],
  "meta": {
    "count": 1,
    "limit": 100
  }
}