About the KK7NQN Ham Radio Network
Project Overview
The KK7NQN Repeater Project is an advanced ham radio monitoring and transcription system that uses AI-powered speech recognition to automatically transcribe and analyze amateur radio communications.
Key Features
- Real-time Transcription: AI-powered speech-to-text using Whisper and other backends
- Callsign Detection: Automatic extraction and validation of callsigns
- Net Detection: AI identifies and logs formal net sessions
- Activity Tracking: Comprehensive logging of all QSO activity
- Open Data: Public API for community access to data
Technology Stack
API Documentation
All endpoints return JSON and support CORS. No authentication required for read-only access.
Base URL
https://yourdomain.com/api/
1. Dashboard Statistics
GET /api/stats.php
Returns overall statistics, recent activity, top callsigns, and recent nets.
GET /api/stats.php
Response Example:
{
"statistics": {
"total_callsigns": 1234,
"active_callsigns": 456,
"total_transcriptions": 50000,
"total_nets": 789
},
"activity": [...],
"top_callsigns": [...],
"recent_transcriptions": [...],
"recent_nets": [...]
}
2. List Callsigns
GET /api/callsigns.php
Search and browse callsigns with pagination.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
page |
integer | 1 | Page number for pagination |
limit |
integer | 50 | Results per page (max 100) |
search |
string | - | Search callsigns by partial match |
validated |
boolean | true | Filter by validation status |
GET /api/callsigns.php?page=1&limit=50&search=KK7
3. Callsign Details
GET /api/callsign.php
Get detailed information about a specific callsign including activity, transcriptions, and net participations.
Query Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
callsign |
string | Yes | The callsign to retrieve |
GET /api/callsign.php?callsign=KK7NQN
4. List Net Sessions
GET /api/nets.php
Browse and search net sessions with filtering options.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
page |
integer | 1 | Page number |
limit |
integer | 50 | Results per page |
search |
string | - | Search net name, club, or summary |
start |
date | - | Filter by start date (YYYY-MM-DD) |
end |
date | - | Filter by end date (YYYY-MM-DD) |
GET /api/nets.php?start=2026-01-01&end=2026-12-31
5. Net Session Details
GET /api/net.php
Get detailed information about a specific net session including participants.
Query Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string (UUID) | Yes | The net session ID |
GET /api/net.php?id=abc123-def456-...
License & Contact
This project is open source and licensed under the GNU General Public License v3.0.
Project Information
- Operator: Hunter Inman (KK7NQN)
- Location: Shelton, Washington
- License: GNU GPL v3.0
- Data Policy: Open Data - All transcriptions and activity logs are publicly accessible
Usage Guidelines
- Please be respectful with API usage - avoid excessive requests
- Use pagination and filtering to minimize data transfer
- Cache responses when possible
- All timestamps are in America/Los_Angeles timezone (PST/PDT)