https://services.aprslive.com

{"detail": "Service 'UNKNOWN' not found"}

{
  "count": 5,
  "timestamp": "2024-01-15T10:30:00Z",
  "services": [
    {
      "callsign": "REPEAT",
      "description": "Find the nearest N repeaters to your current location",
      "service_website": "http://aprs-repeat.hemna.com",
      "software": "APRSD version 3.3.0",
      "callsign_owner": "WB4BOR",
      "status": "active",
      "last_health_check": {
        "timestamp": "2024-01-15T10:00:00Z",
        "success": true,
        "response_time_ms": 1250,
        "error": null
      }
    }
  ]
}

curl https://services.aprslive.com/api/v1/registry

import requests

response = requests.get("https://services.aprslive.com/api/v1/registry")
data = response.json()

print(f"Found {data['count']} services")
for service in data['services']:
    print(f"  {service['callsign']}: {service['description']}")

const response = await fetch("https://services.aprslive.com/api/v1/registry");
const data = await response.json();

console.log(`Found ${data.count} services`);
data.services.forEach(service => {
  console.log(`  ${service.callsign}: ${service.description}`);
});

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

type RegistryResponse struct {
    Count    int       `json:"count"`
    Services []Service `json:"services"`
}

type Service struct {
    Callsign    string `json:"callsign"`
    Description string `json:"description"`
}

func main() {
    resp, err := http.Get("https://services.aprslive.com/api/v1/registry")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var data RegistryResponse
    json.NewDecoder(resp.Body).Decode(&data)

    fmt.Printf("Found %d services\n", data.Count)
    for _, svc := range data.Services {
        fmt.Printf("  %s: %s\n", svc.Callsign, svc.Description)
    }
}

{
  "callsign": "REPEAT",
  "description": "Find the nearest N repeaters to your current location",
  "service_website": "http://aprs-repeat.hemna.com",
  "software": "APRSD version 3.3.0",
  "callsign_owner": "WB4BOR",
  "status": "active",
  "last_health_check": {
    "timestamp": "2024-01-15T10:00:00Z",
    "success": true,
    "response_time_ms": 1250,
    "error": null
  }
}

curl https://services.aprslive.com/api/v1/registry/REPEAT

import requests

callsign = "REPEAT"
response = requests.get(f"https://services.aprslive.com/api/v1/registry/{callsign}")

if response.status_code == 200:
    service = response.json()
    print(f"{service['callsign']}: {service['description']}")
elif response.status_code == 404:
    print(f"Service {callsign} not found")

const callsign = "REPEAT";
const response = await fetch(`https://services.aprslive.com/api/v1/registry/${callsign}`);

if (response.ok) {
  const service = await response.json();
  console.log(`${service.callsign}: ${service.description}`);
} else if (response.status === 404) {
  console.log(`Service ${callsign} not found`);
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    callsign := "REPEAT"
    url := fmt.Sprintf("https://services.aprslive.com/api/v1/registry/%s", callsign)
    
    resp, err := http.Get(url)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    if resp.StatusCode == 200 {
        var service map[string]interface{}
        json.NewDecoder(resp.Body).Decode(&service)
        fmt.Printf("%s: %s\n", service["callsign"], service["description"])
    } else if resp.StatusCode == 404 {
        fmt.Printf("Service %s not found\n", callsign)
    }
}

{
  "callsign": "MYCALL",
  "description": "My APRS service description",
  "service_website": "http://example.com",
  "software": "APRSD 3.3.0",
  "callsign_owner": "N0CALL"
}

curl -X POST https://services.aprslive.com/api/v1/registry \
  -H "Content-Type: application/json" \
  -d '{
    "callsign": "MYCALL",
    "description": "My APRS service",
    "service_website": "http://example.com",
    "software": "APRSD 3.3.0"
  }'

import requests

data = {
    "callsign": "MYCALL",
    "description": "My APRS service",
    "service_website": "http://example.com",
    "software": "APRSD 3.3.0",
}

response = requests.post(
    "https://services.aprslive.com/api/v1/registry",
    json=data
)
print(response.json())

const data = {
  callsign: "MYCALL",
  description: "My APRS service",
  service_website: "http://example.com",
  software: "APRSD 3.3.0",
};

const response = await fetch("https://services.aprslive.com/api/v1/registry", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(data),
});

console.log(await response.json());

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    data := map[string]string{
        "callsign":        "MYCALL",
        "description":     "My APRS service",
        "service_website": "http://example.com",
        "software":        "APRSD 3.3.0",
    }

    jsonData, _ := json.Marshal(data)
    resp, err := http.Post(
        "https://services.aprslive.com/api/v1/registry",
        "application/json",
        bytes.NewBuffer(jsonData),
    )
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

{
  "status": "ok",
  "callsign": "REPEAT",
  "health_check": {
    "timestamp": "2024-01-15T10:30:00Z",
    "success": true,
    "response_time_ms": 1250,
    "error": null
  }
}

curl -X POST https://services.aprslive.com/api/v1/health-check/REPEAT

import requests

callsign = "REPEAT"
response = requests.post(f"https://services.aprslive.com/api/v1/health-check/{callsign}")
result = response.json()

if result["health_check"]["success"]:
    print(f"Health check passed in {result['health_check']['response_time_ms']}ms")
else:
    print(f"Health check failed: {result['health_check']['error']}")

curl -X POST https://services.aprslive.com/api/v1/services/REPEAT/commands \
  -H "Content-Type: application/json" \
  -d '{
    "passcode": "12345",
    "name": "find",
    "description": "Find nearest repeaters to your location",
    "example": "find 5",
    "response_format": "Multi-message reply with repeater info"
  }'

curl https://services.aprslive.com/api/v1/services/REPEAT/commands

{
  "callsign": "REPEAT",
  "commands": [
    {
      "name": "find",
      "description": "Find nearest repeaters to your location",
      "example": "find 5",
      "response_format": "Multi-message reply with repeater info"
    },
    {
      "name": "help",
      "description": "List available commands"
    }
  ]
}

curl "https://services.aprslive.com/api/v1/registry/WXBOT/health-history?limit=50&since=2026-08-01T00:00:00Z"

curl https://services.aprslive.com/api/v1/registry/WXBOT/uptime?period=30d

{
  "callsign": "WXBOT",
  "period": "7d",
  "total_checks": 168,
  "successful_checks": 165,
  "failed_checks": 3,
  "uptime_percent": 98.21,
  "avg_response_time_ms": 142.5
}

<img src="https://services.aprslive.com/api/v1/registry/WXBOT/badge.svg" alt="uptime">

curl https://services.aprslive.com/api/v1/stats

# First request
curl -i https://services.aprslive.com/api/v1/count
# → ETag: "abc123"

# Subsequent poll (returns 304 if unchanged)
curl -H 'If-None-Match: "abc123"' https://services.aprslive.com/api/v1/count

{
  "command": "find weather",
  "from_call": "WEBCLIENT"
}

{
  "command": "find weather",
  "from_call": "WEBCLIENT",
  "responses": ["Found:WXBOT,WXNOW,WXYO"],
  "count": 1
}

curl -X POST https://services.aprslive.com/api/v1/query \
  -H "Content-Type: application/json" \
  -d '{"command": "help"}'

import requests

response = requests.post(
    "https://services.aprslive.com/api/v1/query",
    json={"command": "list weather"}
)
data = response.json()
for msg in data["responses"]:
    print(msg)

const response = await fetch("https://services.aprslive.com/api/v1/query", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ command: "info WXBOT" }),
});
const data = await response.json();
data.responses.forEach(msg => console.log(msg));

const es = new EventSource('/api/v1/events');
es.addEventListener('service.status_changed', (e) => {
  const data = JSON.parse(e.data);
  console.log(`${data.data.callsign}: ${data.data.old_status} → ${data.data.new_status}`);
});
es.addEventListener('vote.cast', (e) => {
  const data = JSON.parse(e.data);
  console.log(`${data.data.voter} voted on ${data.data.callsign}`);
});

# Upvote a service
curl -X POST /api/v1/registry/WXBOT/vote \
  -H "Content-Type: application/json" \
  -d '{"callsign": "KM6LYW", "passcode": 12345, "vote": "up"}'

# Response:
# {"callsign":"WXBOT","voter":"KM6LYW","action":"created",
#  "current_vote":1,"upvotes":1,"downvotes":0,"score":1,"voter_count":1}

# Vote same direction again to toggle off (remove vote)
# Switch "up" to "down" to change direction

GET /api/v1/registry/WXBOT/trust

# {"callsign":"WXBOT","trust_score":65.3,
#  "components":{"uptime_weight":50,"vote_weight":30,"age_weight":20},
#  "votes":{"upvotes":3,"downvotes":0,"score":3,"voter_count":3}}