Quickstart

SuperAge Developer Mode exposes a local read-only HTTPS API from the iOS app. The public documentation at dev.superage.app explains the local contract. It does not host the API and does not proxy requests to a device.

This documentation describes the v1 contract for SuperAge builds that register the Developer Mode data router. Public endpoints work without pairing; scoped data endpoints require a paired client token and return authorization errors instead of disappearing from the router.

Requirements

• SuperAge installed on iPhone.
• Developer Mode enabled in SuperAge Settings.
• Developer Mode terms accepted in the app.
• A paired client approved in the app.
• A client token issued by the pairing flow.

Basic Request

Use the LAN URL shown inside SuperAge Developer Mode. It has this shape:

https://<LAN_IP>:<PORT>

curl --request GET \
  --url "<LAN_API_URL>/api/v1/status"

Scoped endpoints require the Bearer token issued to the paired client:

curl --request GET \
  --url "<LAN_API_URL>/api/v1/metrics" \
  --header "Authorization: Bearer <TOKEN>"

Contract

The public OpenAPI document is available at:

https://dev.superage.app/openapi/v1/openapi.json

The local app may also expose /api/v1/openapi.json while Developer Mode is enabled.